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GIGABIT ETHERNET ADAPTER SUPPORTING THE 
ISCSI AND IPSEC PROTOCOLS 

5 BACKGROUND OF THE INVENTION 

TECHNICAL FIELD 

The invention relates to telecommunications. More particularly, the invention relates 
10 to a method and apparatus for processing data in connection with communication 
protocols that are used to send and receive data. 

DESCRIPTION OF THE PRIOR ART 

15 

Computer networks necessitate the provision of various communication protocols to 
transmit and receive data. Typically, a computer network comprises a system of 
devices such as computers, printers and other computer peripherals, 
communicatively connected together. Data are transferred between each of these 

20 devices through data packets which are communicated through the network using a 
communication protocol standard. Many different protocol standards are in current 
use today. Examples of popular protocols are Internet Protocol (IP), Internetwork 
Packet Exchange (IPX), Sequenced Packet Exchange (SPX), Transmission Control 
Protocol (TCP), and Point to Point Protocol (PPP). Each network device contains a 

25 combination of hardware and software that translates protocols and processes data. 
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An example is a computer attached to a Local Area Network (LAN) system, wherein 
a network device uses hardware to handle the Link Layer protocol, and software to 
handle the Network, Transport, and Communication Protocols and information data 
handling. The network device normally implements the one Link Layer protocol in 

5 hardware, limiting the attached computer to only that particular LAN protocol. The 
higher protocols, e.g. Network, Transport, and Communication protocols, along with 
the Data handlers, are implemented as software programs which process the data 
once they are passed through the network device hardware into system memory. 
The advantage to this implementation is that it allows a general purpose device such 

10 as the computer to be used in many different network setups and support any 
arbitrary network application that may be needed. The result of this implementation, 
however, is that the system requires a high processor overhead, a large amount of 
system memory, complicated configuration setup on the part of the computer user to 
coordinate the different software protocol and data handlers communicating to the 

1 5 computer's Operating System (O.S.) and computer and network hardware. 



This high overhead required in processing time is demonstrated in U.S. Pat. No. 
5,485,460 issued to Schrier et al on Jan. 16, 1996, which teaches a method of 
operating multiple software protocol stacks implementing the same protocol on a 

20 device. This type of implementation is used in Disk Operating System (DOS) based 
machines running Microsoft Windows. During normal operation, once the hardware 
verifies the transport or link layer protocol, the resulting data packet is sent to a 
software layer which determines the packets frame format and strips any specific 
frame headers. The packet is then sent to different protocol stacks where it is 

25 evaluated for the specific protocol. However, the packet may be sent to several 
protocols stacks before it is accepted or rejected. The time lag created by software 
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protocol stacks prevent audio and video transmissions to be processed in real-time; 
the data must be buffered before playback. It is evident that the amount of 
processing overhead required to process a protocol is very high and extremely 
cumbersome and lends itself to applications with a powerful Central Processing Unit 
5 (CPU) and a large amount of memory. 



Consumer products that do not fit in the traditional models of a network device are 
entering the market. A few examples of these products are pagers, cellular phones, 
game machines, smart telephones, and televisions. Most of these products have 

10 small footprints, eight-bit controllers, limited memory or require a very limited form 
factor. Consumer products such as these are simplistic and require low cost and low 
power consumption. The previously mentioned protocol implementations require too 
much hardware and processor power to meet these requirements. The complexity of 
such implementations are difficult to incorporate into consumer products in a cost 

15 effective way. If network access can be simplified such that it may be easily 
manufactured on a low-cost, low-power, and small form-factor device, these 
products can access network services, such as the Internet. 



Communications networks use protocols to transmit and receive data. Typically, a 
20 communications network comprises a collection of network devices, also called 
nodes, such as computers, printers, storage devices, and other computer 
peripherals, communicatively connected together. Data is transferred between each 
of these network devices using data packets that are transmitted through the 
communications network using a protocol. Many different protocols are in current 
25 use today. Examples of popular protocols include the Internet Protocol (IP), 
Internetwork Packet Exchange (IPX) protocol, Sequenced Packet Exchange (SPX) 
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protocol, Transmission Control Protocol (TCP), Point-to-Point Protocol (PPP) and 
other similar new protocols that are under development. A network device contains a 
combination of hardware and software that processes protocols and data packets. 

5 In 1978, the International Standards Organization (ISO), a standards setting body, 
created a network reference model known as the Open System Interconnection 
(OSI) model. The OSI model includes seven conceptual layers: 1) The Physical 
(PHY) layer that defines the physical components connecting the network device to 
the network; 2) The Data Link layer that controls the movement of data in discrete 

10 forms known as frames that contain data packets; 3) The Network layer that builds 
data packets following a specific protocol; 4) The Transport layer that ensures 
reliable delivery of data packets; 5) The Session layer that allows for two way 
communications between network devices; 6) The Presentation layer that controls 
the manner of representing the data and ensures that the data is in correct form; and 

15 7) The Application layer that provides file sharing, message handling, printing and so 
on. Sometimes the Session and Presentation layers are omitted from this model. For 
an explanation of how modern communications networks and the Internet relate to 
the ISO seven-layer model see, for example, chapter 1 1 of the text "Internetworking 
with TCP/IP" by Douglas E. Comer (volume 1, fourth edition, ISBN 0201633469) and 

20 Chapter 1 of the text "TCP/IP Illustrated" by W. Richard Stevens (volume 1, ISBN 
0130183806). 

An example of a network device is a computer attached to a Local Area Network 
(LAN), wherein the network device uses hardware in a host computer to handle the 
25 Physical and Data Link layers, and uses software running on the host computer to 
handle the Network, Transport, Session, Presentation and Application layers. The 
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Network, Transport, Session, and Presentation layers, are implemented using 
protocol-processing software, also called protocol stacks. The Application layer is 
implemented using application software that process the data once the data is 
passed through the network-device hardware and protocol-processing software. The 
5 advantage to this software-based protocol processing implementation is that it allows 
a general-purpose computer to be used in many different types of communications 
networks and supports any applications that may be needed. The result of this 
software-based protocol processing implementation, however, is that the overhead 
of the protocol-processing software, running on the Central Processing Unit (CPU) of 

10 the host computer, to process the Network, Transport, Session and Presentation 
layers is very high. A software-based protocol processing implementation also 
requires a large amount of memory on the host computer, because data must be 
copied and moved as the software processes it. The high overhead required by 
protocol-processing software is demonstrated in U.S. Pat. No. 5,485,460 issued to 

15 Schrier et al. on January 16, 1996, which teaches a method of operating multiple 
software protocol stacks. This type of software-based protocol processing 
implementation is used, for example, in computers running Microsoft Windows. 

During normal operation of a network device, the network-device hardware extracts 
20 the data packets that are then sent to the protocol-processing software in the host 
computer. The protocol-processing software runs on the host computer, and this 
host computer is not optimized for the tasks to be performed by the protocol- 
processing software. The combination of protocol-processing software and a 
general-purpose host computer is not optimized for protocol processing and this 
25 leads to performance limitations. Performance limitations in protocol processing, 
such as the time lag created by the execution of protocol-processing software, is 
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deleterious and may prevent, for example, audio and video transmissions from being 
processed in real-time or prevent the full speed and capacity of the communications 
network from being used. It is evident that the amount of host-computer CPU 
overhead required to process a protocol is very high and extremely cumbersome and 
5 requires the use of the CPU and a large amount of memory in the host computer. 

New consumer and industrial products that do not fit in the traditional models of a 
network device are entering the market and, at the same time, network speed 
continues to increase. Examples of these consumer products include Internet- 

10 enabled cell phones, Internet-enabled TVs, and Internet appliances. Examples of 
industrial products include network interface cards (NICs), Internet routers, Internet 
switches, and Internet storage servers. Software-based protocol processing 
implementations are too inefficient to meet the requirements of these new consumer 
and industrial products. Software-based protocol processing implementations are 

15 difficult to incorporate into consumer products in a cost effective way because of 
their complexity. Software-based protocol processing implementations are difficult to 
implement in high-speed industrial products because of the processing power 
required. If protocol processing can be simplified and optimized such that it may be 
easily manufactured on a low-cost, low-power, high-performance, integrated, and 

20 small form-factor device, these consumer and industrial products can read and write 
data on any communications network, such as the Internet. 

A hardware-based, as opposed to software-based, protocol processing 
implementation, an Internet tuner, is described in J. Minami; R. Koyama; M. 
25 Johnson; M. Shinohara; T. Poff; D. Burkes; Multiple network protocol 
encoder/decoder and data processor, U.S. Patent No. 6,034,963 (March 7, 2000) 



6 



WO 03/105011 PCTAJS03/18049 

(the '963 patent). This Internet tuner provides a core technology for processing 
protocols. 



It would be advantageous to provide a gigabit Ethernet adapter that provides a 
5 hardware solution to high network communication speeds. It would further be 
advantageous to provide a gigabit Ethernet adapter that adapts to multiple 
communication protocols. 

10 SUMMARY OF THE INVENTION 

The invention is embodied in a gigabit Ethernet adapter. A system according to the 
invention provides a compact hardware solution to handling high network 
communication speeds. In addition, the invention adapts to multiple communication 

15 protocols via a modular construction and design. A presently preferred embodiment 
of the invention provides an integrated network adapter for decoding and encoding 
network protocols and processing data. The network adapter comprises a hardwired 
data path for processing streaming data; a hardwired data path for receiving and 
transmitting packets and for encoding and decoding packets; a plurality of parallel, 

20 hardwired protocol state machines; wherein each protocol state machine is 
optimized for a specific network protocol; and wherein said protocol state machines 
execute in parallel; and means for scheduling shared resources based on traffic. 

25 BRIEF DESCRIPTION OF THE DRAWINGS 
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Figure 1 is a block schematic diagram of a NIC Card Implementation according to 
the invention; 



Figure 2 is a block schematic diagram of an Interface for Network Attached Device 
5 according to the invention; 

Figure 3 is a block level diagram of a system according to the invention; 

Figure 4 is a high level block diagram for a gigabit Ethernet adapter according to the 
10 invention; 

Figure 5 is a block schematic diagram that depicts the l/Os used in a MAC Interface 
module according to the invention; 

15 Figure 6 is a block schematic diagram of an Ethernet Interface according to the 
invention; 

Figure 7 is a block schematic diagram of an Address Filter and Packet Type Parser 
module according to the invention; 

20 

Figure 8 is a timing diagram that shows Address Filter and Packet Type Parser 
module operation according to the invention; 

Figure 9 is a block schematic diagram of a Data Aligner Module according to the 
25 invention; 
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Figure 10 is a block schematic diagram of an ARP Module according to the 
invention; 

Figure 1 1 is a block schematic diagram of an ARP Cache according to the invention; 

5 

Figure 12 shows a Transmission Queue Entry Format according to the invention; 

Figure 13 shows a Lookup Table Entry Format according to the invention; 

10 FigureH shows an ARP Cache Entry Format according to the invention; 

Figure 15 is a flow diagram that shows the ARP Lookup Process according to the 
invention; 

1 5 Figure 1 6 is a block schematic diagram of an IP Module according to the invention; 

Figure 17is a block diagram of an ID generator according to the invention; 

Figure 18 is a block diagram depicting the data flow with an Injector according to the 
20 invention; 

Figure 19 is a top-level block diagram for the TCP module according to the invention; 
Figure 20 depicts a TCP Receive data flow according to the invention; 

25 

9 
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Figure 21 shows a VSOCK/Rcv State Handler Control Block Search Resolution Flow 
according to the invention; 

Figure 22 shows a basic data flow according to the invention; 

5 

Figure 23 shows a Socket Receive Data Flow according to the invention; 
Figure 24 shows a Socket Transmit Flow according to the invention; 
1 0 Figure 25 shows a data flow according to the invention; 

Figure 26 shows a block diagram of a module according to the invention; 
Figure 27 shows an algorithm according to the invention; 

15 

Figure 28 is a block diagram for the entire algorithm shown in Figure 27; 
Figure 29 shows logic according to the invention; 
20 Figure 30 shows a format of an option according to the invention; 

Figure 31 shows a format of another option according to the invention; 
Figure 32 shows a format of another option according to the invention; 

25 

Figures 33 and 34 show formats of further options according to the invention; 

10 
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Figure 35 is a block schematic diagram of an IP Router according to the invention; 
Figure 36 shows a format of each IP route entry according to the invention; 

5 

Figure 37 shows signaling used to request and receive a route according to the 
invention; 

Figure 38 is a block schematic diagram of an Exception Handler according to the 
10 invention; 

Figure 39is an M1 memory map according to the invention; 

Figure 40 depicts a sample memory map according to the invention; 

15 

Figure 41 is a block diagram flow for data according to the invention; 

Figure 42 is a block diagram of the mtxarb sub unit according to the invention; 

20 Figure 43 is a block diagram flow for data according to the invention; 

Figure 44 is a block diagram of the mcbarb sub unit according to the invention; 

Figure 45 depicts a default memory map for the network stack according to the 
25 invention; 
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Figure 46 default settings according to the invention; 

Figure 47 shows a matching IB and SB queue which together form a Channel 
according to the invention; 

5 

Figure 48 shows processing flow for an Instruction Block queue according to the 
invention; 

Figure 49 is a block diagram depicting data flow fo ar Status block passing between 
10 a network stack, an on-chip processor, and a Host according to the invention; 

Figure 50 is a block diagram of a iSCSI transmit data path according to the invention; 

Figure 51 shows an iSCSI Transmit Flow Chart according to the invention; 

15 

Figure 52 shows use of a four-byte buffer according to the invention; 

Figure 53 is a block diagram of a iSCSI receive data path according to the invention; 

20 Figure 54 shows a transfer split into two requests according to the invention; 

Figure 55 shows a DMA transfer to a host split into separate requests according to 
the invention; 

25 Figure 56 shows SA Block Flow according to the invention; 
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Figure 57 shows TX AH Transport SA Block Format according to the invention; 
Figure 58 shows TX ESP-1 Transport SA Block Format according to the invention; 
5 Figure 59 shows TX ESP-2 Transport SA Block Format according to the invention; 
Figure 60 shows TX AH Tunnel SA Block Format according to the invention; 
Figure 61 shows TX AH Tunnel SA Block Format according to the invention; 

10 

Figure 62 shows TX ESP-2 Tunnel SA Block Format according to the invention; 

Figure 63 shows RX AH SA Block Format according to the invention; 

15 Figure 64 shows RX ESP-1 SA Block Format according to the invention; 

Figure 65 shows RX ESP-2 SA Block Format according to the invention; 

Figure 66 is a block diagram that depicts the overall flow for the IPSEC logic 
20 according to the invention; 

Figure 67 is a block diagram outlining the data flow according to the invention; 

Figure 68 is a block diagram showing data path flow for received IPSEC packets 
25 according to the invention; and 

13 
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Figure 69 is a flow diagram that shows the IPSEC Anti-Replay Algorithm according 
to the invention. 



5 DETAILED DESCRIPTION OF THE INVENTION 

The invention is embodied in a gigabit Ethernet adapter. A system according to the 
invention provides a compact hardware solution to handling high network 
communication speeds. In addition, the invention adapts to multiple communication 
10 protocols via a modular construction and design. 

Introduction 
General Description 

The invention comprises an architecture to be used in a high-speed hardware 
15 network stack (hereafter referred to as the IT10G). The description herein defines 
the data paths and flows, registers, theory of applications, and timings. Combined 
with other system blocks, the IT10G provides the core for line speed TCP/IP 
processing. 

20 Definitions 

As used herein, the following terms shall have the corresponding meaning: 10Gbps 

10 Gigabit (10,000,000,000 bits per second) 
ACK Acknowledgment 
25 AH Authentication Header 

AHS Additional Header Segment 
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ARP Address Resolution Protocol 

BHS Basic Header Segment 

CB Control Block 

CPU Central Processing Unit 
5 CRC Cyclic Redundancy Check 

DAV Data Available 

DDR Double Data Rate 

DIX Digital Intel Xerox 

DMA Direct Memory Access 
10 DOS Denial of Service 

DRAM Dynamic RAM 

EEPROM Electrically Erasable PROM 

ESP Encapsulating Security Pay load 

FCIP Fiber Channel over IP 
15 FIFO First-ln First-Out 

FIM Fixed Interval Marker 

FIN Finish 

Gb Gigabit (1 ,000,000,000 bits per second) 

H DMA Host DMA 
20 HO Half Open 

HR Host Retransmit 

HSU Header Storage Unit 

IB Instruction Block 

ICMP Internet Control Message Protocol 
25 ID Identification 

IGMP Internet Group Management Protocol 
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IP Internet Protocol 

IPsec IP Security 

IPX Internet Packet Exchange 

IQ Instruction Block Queue 

5 iSCSI Internet Small Computer System Interface 

ISN Initial Sequence Number 

LAN Local Area Network 

LDMA Local DMA 

LIP Local IP Address 

10 LL Linked List 

LP Local Port 

LSB Least-Significant Byte 

LUT Look-Up Table 

MAC Media Access Controller 

15 MCB CB Memory 

MDL Memory Descriptor List 

MIB Management Information Base 

Mil Media Independent Interface 

MPLS Multiprotocol Label Switching 

20 MRX Receive Memory 

MSB Most-Significant Bit 

MSS Maximum Segment Size 

MTU Maximum Transmission Unit 

MTX TX Memory 

25 NAT Network Address Translation 

NIC Network Interface Card 
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NS Network Stack 

OR OR Logic Function 

PDU Protocol Data Unit 

PIP Peer IP Address 
5 PP Peer Port 

PROM Programmable ROM 

PSH Push 

PV Pointer Valid 

QoS Quality of Service 
10 RAM Random Access Memory 

RARP Reverse Address Resolution Protocol 

Rev Receive 

RDMA Remote DMA 

ROM Read-Only Memory 
15 RST Reset 

RT Round Trip 

RTO Retransmission Timeout 

RTT Round-Trip Time 

RX Receive 
20 SA Security Association 

SB Status Blocks 

SEQ Sequence 

SM Status Message 

SNMP Simple Network Management Protocol 
25 SPI Security Parameter Index 

Stagen Status Generator 
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SYN Synchronization 
TCP Transport Control Protocol 
TOE Transport Offload Engine 
TOS Type of Service 
5 TTL Time to Live 
TW Time Wait 
TX Transmit 
UDP User Datagram Protocol 
URG Urgent 
10 VLAN Virtual LAN 

VSOCK Virtual Socket 
WS Window Scaling 
XMTCTL Transmit Control 
XOR Exclusive-OR 

15 

Application Overview 

Overview 

20 As bandwidth continues to increase, the ability to process TCP/IP communications 
becomes more of an overhead for system processors. Many sources state that as 
Ethernet rates reach the gigabit per second (Gbps) rate, that TCP/IP protocol 
processing will consume close to 100% of the host computer's CPU bandwidth, and 
when the rates increase further to 10 Gbps, that the entire TCP/IP protocol 

25 processing must be off-loaded to dedicated sub-systems. The herein described 
IT10G implements TCP and IP, along with related protocols including, for example, 
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ARP, RARP, and IP host routing, as a series of state machines. The IT 10G core 
forms an accelerator or engine, also known as a Transport Offload Engine (TOE). 
The IT10G core uses no processor or software, although hooks are provided so that 
a connected on-chip processor can handle be used to extend the features of the 
5 network stack. 

Sample Applications 

An example usage of the IT10G core is an Intelligent Network Interface Card (NIC). 
10 In a typical application, the NIC is plugged into a computer server and natively 
processes TCP/UDP/IP packets. 

Figure 1 is a block schematic diagram of a NIC Implementation of the invention. In 
Figure 1, the IT 10G core 10 is combined with a processor 11, system peripherals 

15 12, and a system bus interface 13 into a single-chip NIC controller. The single-chip 
NIC controller is integrated with an Ethernet PHY 14, combined with a configuration 
EEPROM 15, and optional external memory for the network stack to form a low chip 
count NIC. The processor memory 16 (both ROM and RAM) may be internal to the 
integrated chip or reside externally. 

20 Another usage for the IT 10G is to function as the interface for network attached 
devices, such as storage units, printers, cameras, and so forth. In these cases, a 
custom application socket (or interface) 17 can be designed into the IT 10G to 
process layer 6 and 7 protocols and to facilitate data movement specific for that 
application. Examples include custom data paths for streaming media, bulk data 

25 movements, and protocols such as iSCSI and FCIP. 
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Figure 2 is a block schematic diagram of an Interface for Network Attached Device 
according to the invention. Although the IT 10G is designed to support line speed 
processing at 10 Gbps rates, the same architecture and logic may also be used at 
lower speeds . In these cases, the only difference is in the Ethernet MAC 21 and 
5 PHY 14. Advantages of using this architecture at slower line speeds include lower 
power consumption, for example. 

The Challenge 

10 The challenge for high-speed bandwidths is in processing TCP/IP packets at wire 
line speeds. This is shown in the following table. 



Table 1 . Processing Power Requirements 



Rate 


Bytes / sec 


Packets / sec 1 


Instr / sec 2 


10 Mbps 


1,000,000 


2,000 


2 MIPs 


100 Mbps 


10,000,000 


20,000 


20 MIPs 


1 Gbps 


100,000,000 


200,000 


200 MIPs 


10 Gbps 


1,000,000,000 


2,000,000 


2 GIPs 



Notes: 1 This assumes an average packet size of 500 bytes 

2 This assumes 500 instruction overhead per packet and 1 
instruction per byte 



15 The figures in the above table are very conservative, and do not take into account, 
for example, the full duplex nature of networking. If full-duplex operation is factored 
in, then the processing power requirements can easily double. In any case, it is 
apparent that starting at the gigabit level, the processing overhead of TCP/IP 

20 
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becomes a major drain on host computer processing power and that another solution 
is needed. 



Bandwidth Limitation 

5 

The IT10G addresses the limitation of host computer processing power by various 
architecture implementations. These include the following features: 

• On the fly (streaming) processing of incoming and outgoing data 
10 • Ultra wide datapaths (64 bits in the current implementation) 

• Parallel execution of protocol state machines 

• Intelligent scheduling of shared resources 

• Minimized memory copying 

15 System Overview 

Overview 

This section describes the top level of the preferred embodiment. It provides a block 
20 level description of the system as well as a theory of operation for different data 
paths and transfer types. 

This embodiment of the invention incorporates the IT10G network stack and 
combines it with a processor core, and system components to provide a complete 
25 networking sub-system for different applications. A block level diagram for the 
system is shown in Figure 3. 

21 
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Clock Requirements 

The presently preferred embodiment of the invention is a chip that is designed to 
5 operate with different clock domains. The following table lists all clock domains for 
both 1 Gbps and 10 Gbps operations. 



Table 2. Clock Domains 



Domain 


Symbol 


1 Gb 
(Mhz) 


10 Gb 
(MHz) 


Notes 


MAC 


CLK MAC 


125 


125 




System Clock 


CLK C0RE 


20 


200 


This clock serves the 
network stack and the on- 
chip processor core 


System 
Interface 


CLK SY s 


66/133 


133 


PCI 64/66 or PCI-X 133 is 
used for 1 Gbps. PCI- 
Express is used for 10 
Gbps. 



10 PROTOCOL PROCESSOR 



Overview 



This section provides an overview of the internal Protocol processor. 

15 

Processor Core 

22 
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The herein described chip uses an internal (or on-chip) processor for 
programmability and flexibility. This processor is also furnished with all the 
peripherals needed to complete a working system. Under normal operating 
5 conditions, the on-chip processor controls the network stack. 

Memory Architecture 

The on-chip processor has the capability to address up to 4 GBytes of memory. 
10 Within this address space are located all of its peripherals, its RAM, ROM, and the 
network stack. 

Network Stack Architecture 

15 Overview 

This section overviews the IT 10G architecture. Subsequent sections herein go into 
detail on individual modules. The 1T10G takes the hardware protocol processing 
function of a network stack, and adds enhancements that enable it to scale up to 10 
20 Gbps rates. The major additions to previous versions are widening of the data 
paths, parallel execution of state machines, and intelligent scheduling of shared 
resources. In addition, other protocols previously not supported are added with 
support for protocols such as RARP, ICMP, and IGMP. Figure 4 is a high level block 
diagram for the IT 10G. 

25 

Theory of Operation 
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TCP / UDP Socket Initialization 

Prior to transferring any data using the IT 10G, a socket connection must be 
5 initialized. This can be done either by using commands blocks or by programming 
up the TCP socket registers directly. Properties that must be programmed for every 
socket include the Destination IP address, Destination Port number, and type of 
connection (TCP or UDP, Server or Client, for example). Optional parameters 
include such settings as a QoS level, Source Port, TTL, and TOS setting. Once 
10 these parameters have been entered, the socket may be activated. In the case of 
UDP sockets, data can start to be transmitted or received immediately. For TCP 
clients, a socket connection must first be established, and for TCP servers a SYN 
packet must be received from a client, and then a socket connection established. All 
these operations may be performed completely by the IT 1 0G hardware. 

15 

Transmission of Packets 

When TCP packets need to be transmitted, the application running on the host 
computer first writes the data to a socket (either a fixed socket or virtual socket - 

20 virtual sockets are supported by the IT 10G architecture). If the current send buffer 
is empty, then a partial running checksum is kept as the data is being written to 
memory. The partial checksum is used as the starting seed for checksum 
calculations, and alleviates the need for the TCP layers in the IT 10G network stack 
to read through the data again prior to sending data out. Data can be written to the 

25 socket buffer in either 32-bit or 64-bit chunks. Up to four valid_byte signals are used 
to indicate which bytes are valid. Data should be packed when writing to the socket 
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buffers, with only the last word having possible invalid bytes. This stage also applies 
to UDP packets for which there is an option of not calculating the data checksum. 



Once all the data has been written, the SEND command can be issued by the 
5 application running on the host computer. At this point, the TCP/UDP engine 
calculates the packet length, checksums and builds the TCP/IP header. This TCP/IP 
header is pre-pended to the socket data section. The buffer pointer for the packet, 
along with the sockets QoS level is then put on the transmission queue. 

10 The transmission scheduler looks at all sockets that have pending packets and 
selects the packet with the highest QoS level. This transmission scheduler looks at 
all types of packets that need transmission. These packets may include TCP, UDP, 
ICMP, ARP, RARP, and raw packets, for example. A minimum-bandwidth algorithm 
is used to make sure that no socket is completely starved. When a socket packet is 

15 selected for transmission, the socket buffer pointer is passed to the MAC TX 
Interface. The MAC TX Interface is responsible for reading the data from the socket 
buffer and sending the data to the MAC. A buffer is used to store the outgoing 
packet in case it needs to be retransmitted due to Ethernet collisions or for other 
reasons. Once the packet data is sent from the original socket buffer, then that data 

20 buffer is freed. When a valid transmit status is received back from the MAC, the data 
buffer is flushed, and the next packet can then be sent. If an invalid transmission 
status is received from the MAC, then the last packet stored in the data buffer is 
retransmitted. 

25 Reception of Packets 
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When a packet is received from the MAC, the Ethernet header is parsed to 
determine if the packet is destined for this network stack. The MAC address filter 
may be programmed to accept a unicast addresses, unicast addresses that fall 
within a programmed mask, broadcast addresses, or multicast addresses. In 
5 addition, the encapsulating protocol is also determined. If the 16-bit TYPE field in 
the Ethernet header indicates an ARP (0x0806) or RARP (0x0835) packet, then the 
ARP/RARP module is enabled to further process the packet. If the TYPE field 
decodes to IPv4 (0x0800), then the IP module is enabled to process the packet 
further. A complete list of example supported TYPE fields is shown in the following 

10 table. If the TYPE field decodes to any other value, the packet may optionally be 
routed to a buffer and the host computer notified that an unknown Ethernet packet 
has been received. In this last case, the application may read the packet, and 
determine the proper course of action. With this construction of the datapath any 
protocol not directly supported in hardware, such as IPX for example, may be 

1 5 indirectly supported by the IT1 0G. 
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Table 3 Supported Ethernet TYPE Field Values 



TYPE Field 1 


Description 


0x0800 | 


IPv4 Packet 


0x0806 


ARP Packet 


0x8035 


RARP Packet 


0x8100 


VLAN Tagged Packets 


0x8847 


MPLS Unicast Packets 


0x8848 


MPLS Multicast Packets 



Note: IPv6 packets are handled as exceptions at the Ethernet layer. 

5 ARP / RARP Packets 

If the received packet is an ARP or RARP packet, then the ARP/RARP module is 
enabled. It examines the OP field in the packet and determines if it is a request or a 
reply. If it is a request, then an outside entity is polling for information. If the address 
10 that is being polled is for the IT 10G, then a reply_req is sent to the ARP/RARP reply 
module. If the packet received is an ARP or RARP reply, then the results, i.e. the 
MAC and IP addresses, are sent to the ARP/RARP request module. 

In an alternative embodiment the ARP and/or RARP functions are handled in the 
15 host computer using dedicated and optimized hardware in the IT10G to route 
ARP/RARP packets to the host via the exception path. 

IP Packets 
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If the received packet is an IP packet, then the IP module is enabled. The IP module 
first examines the version field in the IP header to determine if the received packet is 
an IPv4 packet. 

5 The IP module parses the embedded protocol of the received packet. Depending on 
what protocol is decoded, the received packet is sent to the appropriate module. 
Protocols supported directly by hardware in the current embodiment include TCP 
and UDP, for example. Other protocols, such as RDMA, may be supported by other 
optimized processing modules. All unknown protocols are processed using the 
10 exception handler. 

TCP Packets 

If a TCP packet is received by the IT 10G, then the socket information is parsed, and 
15 the corresponding socket enabled. The state information of the socket is retrieved, 
and based on the type of packet received, the socket state is updated accordingly. 
The data payload of the packet (if applicable) is stored in the socket data buffer. If 
an ACK packet needs to be generated, the TCP state module generates the ACK 
packet and schedules the ACK packet for transmission. If a TCP packet is received 
20 that does not correlate to an open socket, then the TCP state module generates a 
RST packet and the RST packet is scheduled for transmission. 

UDP Packets 
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If a UDP packet is received, then the socket information is parsed, and the data 
stored in the socket receive data buffer. If no open socket exists, then the UDP 
packet is silently discarded. 

5 In an alternative embodiment UDP packets may be handled by the host computer 
using the exception handler. 

Network Stack Registers 

1 0 The hardware network stack of the IT 1 0G is configured to appear as a peripheral to 
the on-chip processor. The base address for the network stack is programmed via 
the on-chip processor's NS_Base_Add register. This architecture allows the on-chip 
processor to put the network stack at various locations in its memory or I/O space. 

15 Ethernet MAC Interface 

Overview 

The following discussion describes the Ethernet MAC interface module. The 
20 function of the Ethernet MAC interface module is to abstract the Ethernet MAC from 
the core of the IT10G. This allows the IT 10G network stack core to be coupled to 
different speed MACs and/or MACs from various sources without changing the 
IT10G core architecture, for example. This section describes the interface 
requirements for communication with the IT10G core. 

25 

Module l/Os 
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Figure 5 is a block schematic diagram that depicts the l/Os used in MAC Interface 
module. 

5 Ethernet Interface 

Overview 

This section describes the Ethernet Interface module. The Ethernet interface 
10 module communicates with the Ethernet MAC interface at the lower end, and to 
blocks such as the ARP, and IP modules on the upper end. The Ethernet interface 
module handles data for both the receive and transmit paths. On the transmit side, 
the Ethernet interface module is responsible for scheduling packets for transmission, 
setting up DMA channels for transmission, and communicating with the Ethernet 
15 MAC interface transmit signals. On the receive side, the Ethernet interface module 
is responsible for parsing the Ethernet header, determining if the packet should be 
received based upon address filter settings, enabling the next encapsulated protocol 
based upon the TYPE field in the packet header, and aligning the data so that it 
starts on a 64-bit boundary for the upper layer protocols. Figure 6 is a block 
20 schematic diagram of the Ethernet Interface 40. 

Sub Module Block Descriptions 

Transmission Scheduler 

25 
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The Transmission Scheduler block 60 is responsible for taking transmission requests 
from the ARP, IP, TCP, and Raw transmission modules, and determining which 
packet should be sent next. The Transmission Scheduler determines transmission 
order by comparing QoS levels for each transmission request. Along with the QoS 
5 level, each transmission request contains a pointer to the starting memory block for a 
packet, along with a packet length. The transmission scheduler has the capability to 
be programmed to weigh the transmission priority of certain packet types more 
heavily than others. For example, a QoS level of five from the TCP module can be 
made to count for more than a level five request from the IP module. The 
10 Transmission Scheduler allows multiple modules to operate in parallel and shared 
fashion that depends on transmit data traffic. The following is the algorithm currently 
used to determine packet scheduling. 

Check to see that no packet channel has reached the starved state. This is a 
15 programmable level, per channel type, i.e. TCP, IP, ARP, and Raw buffers, that 
states how many times a channel is passed over before the scheduler over-rides the 
QoS level and the packet is sent out. If two or more packets have reached the 
starved state at the same time, then the channel with the higher weighting is given 
priority. The other packet is then scheduled to be sent next. If the packets have the 
20 same priority weighting they are sent out one after the other according to the 
following order; TCP/ UDP then ARP then IP then Raw Ethernet. 

If no channel has a packet in the starved state, then the channel with the highest 
combined QoS level and channel weighting is sent. 

25 

If only one channel has a packet to be sent, it is sent immediately. 
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Once a packet channel has been selected for transmission, the channel memory 
pointer, packet length, and type are passed to the DMA engine. The DMA engine in 
turn signals back to the transmission scheduler when the transfer has been 
5 completed. At this point the scheduler sends the packet parameters to the DMA 
engine. 

DMA Engine 

10 The DMA Engine 61 receives packet parameters from the transmission scheduler. 
Packet parameters include packet type, packet length, and starting memory pointer. 
The DMA engine uses the packet length to determine how many data bytes to 
transfer from memory. The packet type indicates to the DMA engine from which 
memory buffer to retrieve the data, and the starting memory pointer indicates from 

15 where to start reading data. The DMA engine needs to understand how big each of 
the memory blocks used in the channel packet is because an outgoing packet may 
span multiple memory blocks. The DMA engine receives data 64 bits at a time from 
the memory controllers and passes data 64 bits at a time to the transmitter interface. 

20 Transmitter Interface 

The Transmitter Interface 62 takes the output from the DMA engine and generates 
the macoutjock, macout_rdy, macout_eof, and macout_val_byte signals for the 
Ethernet MAC interface. The 64 bit macout_data bus connects directly from the 
25 DMA Engine to the Ethernet MAC Interface. 
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Receiver Interface 

The Receiver Interface 63 is responsible for interfacing with the Ethernet MAC 
interface. The Receiver Interface takes data in and presents the data along with 
5 state count information to the Address Filter and Packet Type Parser block. 

Address Filter and Packet Type Parser 

The Address Filter and Packet Type Parser 64 parses the Ethernet header and 
1 0 performs two major functions: 

• Determine if the packet is for the local network stack 

• Parse the encapsulated packet type to determine where to send the rest of 
the packet. 

15 

Address Filtering 

The network stack can be programmed with the following filter options: 

20 • Accept a programmed unicast address 

• Accept broadcast packets 

• Accept multicast packets 

• Accept addresses within a range specified by a netmask 

• Promiscuous mode (accepts all packets) 

25 

These parameters are all settable by the host computer via registers. 
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Packet Types Supported 

The following packet types are known by the IT10G hardware and are natively 
5 supported: 

• IPv4 packets with type = 0x8000 

• ARP packets with type = 0x0806 

• RARP packets with type = 0x8035 

10 

The packet type parser also handles the case where an 802.3 length parameter is 
included in the TYPE field. This case is detected when the value is equal to or less 
then 1500 (decimal). When this condition is detected, the type parser sends the 
encapsulated packet to both the ARP and IP receive modules, along with asserting 
15 an 802_frame signal so that each subsequent module realizes that it must decode 
the packet with the knowledge that it may not be really meant for that module. 

Note: IPv6 packets are treated as exception packets by the Ethernet layer. 

20 Figure 7 is a block schematic diagram of an Address Filter and Packet Type Parser 
module, and Figure 8 is a timing diagram that shows Address Filter and Packet Type 
Parser module operation. For I/O timing, the signals that indicate the packet types 
remain asserted until the macinjock signal that corresponds to that packet has been 
de-asserted. All _packet signals also only trigger if the destination MAC address is 

25 acceptable. 
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If the Address Filter and Packet Type Parser module parses a packet that it does not 
understand, and if the unsupported type feature is enabled, then the packet is routed 
to the Exception Handler for storage and further processing. 

5 Data Aligner 

The Data Aligner 65 is responsible for aligning data bytes for the following layers of 
packet processing. The Data Aligner is needed because the Ethernet header is not 
an even multiple of 64 bits. Depending on whether VLAN tags are present or not, 

10 the data aligner re-orients the 64-bit data so that to the upper processing layers, the 
data is MSB justified. This way the payload section of the Ethernet frame is always 
aligned on an even 64-bit boundary. The Data Aligner is also responsible for 
generating the ready signal to the next layers. The ready signal goes active two or 
three ready cycles after macin_rdy gets asserted. Figure 9 is a block schematic 

15 diagram of an implementation Data Aligner Module. 

Ethernet Packet Formats 

The IT10G accepts both 802.3(SNAP) and DIX format packets from the network, but 
20 only transmits packets in DIX format. Furthermore, when 802.3 packets are 
received, they are first translated into DIX format, and then processed by the 
Ethernet filter. Therefore, all Ethernet exception packets are stored in DIX format. 

ARP Protocol and ARP Cache Modules 

25 

Overview 
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The following discussion details the ARP Protocol and ARP Cache modules. In one 
embodiment of the IT10G architecture, the ARP protocol module also supports the 
RARP protocol, but does not include the ARP cache itself. Because each module 
5 capable of transmitting a packet queries the ARP cache ahead of time, this common 
resource is separated from this ARP module. The ARP Protocol and ARP Cache 
module may send updates to the ARP cache based upon packet types received. 



ARP Feature List: 

Able to respond to ARP requests by generating ARP replies 
Able to generate ARP requests in response to the ARP cache 
Able to provide ARP replies for multiple IP addresses (multi-homed host / 
ARP proxy) 

Able to generate targeted (unicast) ARP requests 
Filters out illegal addresses 
Passes aligned ARP data up to the processor 
Capable of performing a gratuitous ARP 

CPU may bypass automatic ARP reply generation, dumping ARP data into 
the exception handler 

CPU may generate custom ARP replies (when in bypass mode) 
Variable priority of ARP packets, depending on network conditions 



RARP Feature List: 

• Request an IP address 

25 • Request a specific IP address 

• RARP requests are handed off to the exception handler 
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• Handles irregular RARP replies 

• Passes aligned RARP data up to the processor 

• CPU may generate custom RARP requests and replies 

5 ARP Cache Features: 

• Dynamic ARP table size 

• Automatically updated ARP entry information 

• Interrupt when sender's hardware address changes 

• Capable of promiscuous collection of ARP data 

10 • Duplicate IP address detection and interrupt generation 

• ARP request capability via the ARP module 

• Support for static ARP entries 

• Option for enabling static ARP entries to be replaced by dynamic ARP data 

• Support for ARP proxying 

1 5 • Configurable expiration time for ARP entries 

(The CPU may be either the host computer CPU or the on-chip processor in this 
context.) 

ARP Module Block Diagram 

20 

Figure 10 is a block schematic diagram of one implementation of an ARP Module 
Block. 

ARP Cache Module Block Diagram 

25 
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Figure 11 is a block schematic diagram of one implementation of an ARP Cache 
Block. 



ARP Module Theory of Operations 

5 

Parsing Packets 

The ARP module 1 00 only processes ARP and RARP packets. The module waits 
for a ready signal received from Ethernet receive module. When that signal is 
1 0 received, the frametype of the incoming Ethernet frame is checked. If the frametype 
is not ARP/RARP, the packet is ignored. Otherwise, the module begins parsing. 

Data is read from the Ethernet interface in 64-bit words. An ARP packet takes up 
3.5 words. The first word of an ARP-type packet contains mostly static information. 

15 The first 48 bits of the first word of an ARP-type packet contain the Hardware Type, 
Protocol Type, Hardware Address Length, and Protocol Address Length. These 
received values are compared with the values expected for ARP requests for IPv4 
over Ethernet. If the received values do not match, the data is passed to the 
exception handler for further processing. Otherwise, the ARP module continues with 

20 parsing. The last 16 bits of the first word of an ARP-type packet contain the opcode. 
The ARP module stores the opcode and checks if it is valid, i.e. 1, 2 or 4. If the 
opcode is invalid, the data is passed to the exception handler for further processing. 
Otherwise, the ARP module continues with parsing. 

25 The second word of an ARP-type packet contains the Source Ethernet Address and 
half of the Source IP Address. The ARP module stores the first 48 bits into the 
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Source Ethernet Address register. Then the ARP module checks if this field is a 
valid Source Ethernet Address. The address should not be same as the address of 
the IT 10G network stack. If the source address is invalid, the packet is discarded. 
The last 16 bits of the packet are then stored in the upper half of the Source IP 
5 Address register. 

The third word of an ARP-type packet contains the second half of the Source IP 
Address and the Target Ethernet Address. The ARP module stores the first 16 bits 
in the lower half of the Source IP Address register, and checks if this stored value is 
a valid Source IP Address. The address should not be same as that of the IT10G 
hardware, or the broadcast address. Also, the source address should be in the 
same subnet. The ARP module discards the packet if the source address is invalid. 
If the packet is an ARP/RARP reply, compare the Target Hardware Address with my 
Ethernet address. If the address does not match, the ARP module discards the 
packet. Otherwise the ARP module continues with parsing. 

Only the first 32 bits of the last word of an ARP-type packet contain data (the Target 
IP Address). The ARP module stores the Target IP Address in a register. If the 
packet is an ARP packet (as opposed to ARP request or RARP packet), compare 
20 the Target IP Address with my IP address. If the addresses do not match, discard 
this packet. Otherwise, if this packet is an ARP request, generate an ARP reply. If 
this is a RARP reply, pass the assigned IP address to the RARP handler. 

Once all the address data have been validated, the source addresses are passed to 
25 the ARP Cache. 
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Transmitting Packets 

The ARP module may receive requests for transmitting packets from three sources: 
the ARP Cache 110 (ARP requests), internally from the parser/FIFO buffer (for ARP 
5 replies), and from the system controller or host computer (for custom ARP/RARP 
packets). Because of this situation, a type of priority-queue is necessary for 
scheduling the transmission or ARP/RARP packets. 

Transmission requests are placed in the queue in a first-come first-served order, 
10 except when two or more entities want to transmit. In that case, the next request 
placed in the queue depends on its priority. RARP requests normally have the 
highest priority, followed by ARP requests. ARP replies usually have the lowest 
priority. Using priority allows resources to be shared depending on data traffic. 

15 There is one condition where ARP replies have the highest priority. This occurs 
when ARP reply FIFO buffer is filled. When the FIFO buffer is filled, incoming ARP 
requests begin to be discarded, therefore ARP replies should have the highest 
priority at that point to avoid forcing retransmissions of ARP requests. 

20 When the transmission queue is full, no more requests may be made until one or 
more transmission requests have been fulfilled (and removed from the queue). 
When the ARP module detects a full queue, it requests an increase in priority from 
the transmission arbiter. Because there should be only two conditions for the queue, 
full or not full, this request signal may be a single bit. 

25 
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When the transmission arbiter allows the ARP module to transmit, ARP/RARP 
packets are generated dynamically depending on the type of packet to be sent. The 
type of packet is determined by the opcode, which is stored with each entry in the 
queue. Figure 12 shows a Transmission Queue Entry Format. 

5 

Bypass Mode 

The ARP module has the option of bypassing the automatic processing of incoming 
packet data. When a bypass flag is set, incoming ARP/RARP data are transferred to 
the exception handler buffer. The CPU then accesses the buffer, and processes the 
data. When in bypass mode, the CPU may generate ARP replies on its own, 
passing data to the transmission scheduler. The fields that can be customized in 
outgoing ARP/RARP packets are: the source IP address, the source Ethernet 
address, the target IP address, and the opcode. All other fields match the standard 
values used in ARP/RARP packets for IPv4 over Ethernet, and the source Ethernet 
address is set to that of the Ethernet interface. (The CPU may be either the host 
computer or the on-chip processor in this context.) 

Note: If it is necessary to modify these other ARP/RARP fields, the CPU must 
20 generate a raw Ethernet frame itself. 

ARP Cache Theory of Operation 

Adding Entries to the ARP Cache 

25 
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ARP entries are created when receiving targeted ARP requests and replies 
(dynamic), or when requested by the CPU (static). (The CPU may be either the host 
computer or the on-chip processor in this context.) Dynamic entries are ARP entries 
that are created when an ARP request or reply is received for one of the interface IP 
addresses. Dynamic entries exist for a limited time as specified by the user or 
application program running on the host computer; typically five to 15 minutes. 
Static entries are ARP entries that are created by the user and do not normally 
expire. 

New ARP data come from two sources: the CPU via the ARP registers and the ARP 
packet parser. When both sources request to add an ARP entry at the same time 
the dynamic ARP entries have priority, because it is necessary to process incoming 
ARP data as quickly as possible. 

Once an ARP data source has been selected, we need to determine where in IT 10G 
hardware memory the ARP entry is to be stored. To do this we use a lookup table 
(LUT) to map a given IP address to a location in memory. The lookup table contains 
256 entries. Each entry is 16 bits wide and contains a memory pointer and a pointer 
valid (PV) bit. The PV bit is used determine if the pointer is pointing to a valid 
address, i.e. the starting address of a memory block allocated by the ARP cache. 
Figure 13 shows a Lookup Table Entry Format. 

To determine from where in the LUT we need to retrieve the pointer, we use an 8-bit 
index. The index is taken from the last octet of a 32-bit IP address. The reason for 
using the last octet is that in a local area network (LAN) this is the portion of the IP 
address that varies the most between hosts. 
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Once we determine which slot in the LUT to use, we check to see if there is a valid 
pointer contained in that slot (PV = "1"). If there is a valid pointer, that means there 
is a block of memory allocated for this index, and the target IP address may be found 
5 in that block. At this point, the block of memory being pointed to is retrieved and the 
target IP address is searched for. If the LUT does not contain a valid pointer in this 
slot, then memory must be allocated from an internal memory, mallocl . Once the 
memory has been allocated the address of the first word of the allocated memory is 
stored in the pointer field of the LUT entry. 

10 

After allocating memory and storing the pointer in the LUT, we need to store the 
necessary ARP data. This ARP data includes the IP address, necessary for 
determining if this is the correct entry during cache lookups. Also used is a set of 
control fields. The retry counter is used to keep track of the number of ARP request 

15 attempts performed for a given IP address. The type field indicates the type of 
cache entry (000 = dynamic entry; 001 = static entry; 010 = proxy entry; 01 1 = ARP 
check entry). The resolved flag indicates that this IP address has been successfully 
resolved to an Ethernet address. The valid flag indicates that this ARP entry 
contains valid data. Note: an entry may be valid and unresolved while the initial ARP 

20 request is being performed. The src field indicates the source of the ARP entry (00 = 
dynamically added, 01 = system interface, 10 = IP router, and 11 = both system 
interface and IP router). The interface field allows the use of multiple Ethernet 
interfaces, but defaults to a single interface (0). Following the controls fields is the 
link address that points to the following ARP entry. The most significant bit (MSB) of 

25 the link address is actually a flag, link_valid. The link_valid bit indicates that there is 
another ARP entry following this one. The last two fields are the Ethernet address to 
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which the IP address has been resolved, and the timestamp. The timestamp 
indicates when the ARP entry was created, and is used to determine if the entry has 
expired. Figure14 shows an example of the ARP Cache Entry Format 

5 In LANs with more than 256 hosts or with multiple subnets, collisions between 
different IP addresses may occur in the LUT. In other words, more than one IP 
address may map to the same LUT index. This would be due to more than one host 
having a given value in the last octet of its IP address. To deal with collisions, the 
ARP cache uses chaining., which we describe next. 

10 

When performing a lookup in the LUT, and an entry is found to already exist in that 
slot, we retrieve the ARP entry that is being pointed to from memory. We examine 
IP address in the ARP entry and compare it to the target IP address. If the IP 
addresses match then we can simply update the entry. However, if the addresses 

15 do not match, then we look at the Link_Valid flag and the last 16 bits of ARP entry. 
The last 16 bits contain a link address pointing to another ARP entry that maps to the 
same LUT index. If the Link_Valid bit is asserted, then we retrieve the ARP entry 
pointed to in the Link Address field. Again the IP address in the entry is compared 
with the target IP address. If there is a match then the entry is updated, otherwise 

20 the lookup process continues (following the links in the chain) until a match is found 
or the Link_Valid bit is not asserted. 

When the end of a chain is reached and a match has not been found, a new ARP 
entry is created. Creating a new ARP entry may require the allocation of memory by 
25 the mallod memory controller. Each block of memory is 128 bytes in size. Thus, 
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each block can accommodate 8 ARP entries. If the end of a block has been 
reached, then a new memory block must be requested from mallocl . 



As previously mentioned, the user (or application running on the host computer) has 
5 the option of creating static or permanent ARP entries. The user may have the 
option of allowing dynamic ARP data to replace static entries. In other words, when 
ARP data are received for an IP address that already has a static ARP entry created 
for it, that static entry may be replaced with the received data. The benefit of this 
arranegment is that static entries may become outdated and allowing dynamic data 
10 to overwrite static data may result in a more current ARP table. This update 
capability may be disabled if the user is confident that IP-to-Ethernet address 
mappings will remain constant, e.g. storing the IP and Ethernet addresses of a router 
interface. The user may also choose to preserve static entries to minimize the 
number of ARP broadcasts on a LAN. Note: ARP proxy entries can never be 
15 overwritten by dynamic ARP data. 

Looking Up Entries in the Cache 

Looking up entries in the ARP cache follows a process similar to that for creating 
20 ARP entries. Lookups begin by using the LUT to determine if memory has been 
allocated for a given index. If memory has been allocated, the memory is searched 
until either the entry is found (a cache hit occurs), or an entry with the link_valid flag 
set to zero (a cache miss) is encountered. 

25 If a cache miss occurs, an ARP request is generated. This involves creating a new 
ARP entry in the cache, and a new LUT entry if necessary. In the new ARP entry, 
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the target IP address is stored, the resolved bit is set to zero and the valid bit is set 
to one. The request counter is set to zero as well. The entry is then time stamped 
and an ARP request is passed to the ARP module. If a reply is not received after 
one second, then the request counter is incremented and another request is sent. 
5 After sending three requests and receiving no replies, attempts to resolve the target 
IP are abandoned. Note: the retry interval and number of request retries are user- 
configurable. 

When a cache miss occurs, the requesting module is notified of the miss. This 
10 allows the CPU or IP router the opportunity to decide to wait for an ARP reply for the 
current target IP address, or to begin a new lookup for another IP address and place 
the current IP address at the back of the queue. This helps to minimize the impact of 
a cache miss on establishing multiple connections. Figure 15 is a flow diagram that 
shows the ARP Lookup Process. 

15 

If a matching entry is found (cache hit) then the resolved Ethernet address is 
returned to the module requesting the ARP lookup. Otherwise if, the target IP 
address was not found in the cache, and all ARP request attempts have timed out, 
the requesting module is notified that the target IP address could not be resolved. 

20 

Note: if an ARP lookup request from the IP router fails, the router must wait a 
minimum of 20 seconds before initiating another lookup for that address. 

Cache Initialization 

25 
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When the ARP cache is initialized several components are reset. The lookup table 
(LUT) is cleared, by setting all the PV bits to zero. All memory currently in use is de- 
allocated and released back to the mallocl memory controller. The ARP expiration 
timer is also set to zero. 

5 

During the initialization period, no ARP requests are generated. Also, any attempts 
to create ARP entries from the CPU (static entries), or from received ARP data 
(dynamic entries) are ignored or discarded. 

10 Expiring ARP Entries 

Dynamic ARP entries may only exist in the ARP cache for a limited amount of time. 
This is to prevent any IP-to-Ethernet address mappings from becoming stale. 
Outdated address mappings could occur if a LAN uses DHCP to assign IP 
15 addresses or if the Ethernet interface on a device is changed during a 
communications session. 

To keep track of the time, a 16-bit counter is used. Operating with a clock frequency 
of 1 Hz the counter is used to track the number of seconds that have passed. Each 
20 ARP entry contains a 16-bit timestamp taken from this counter. This timestamp is 
taken when an IP address is successfully resolved. 

ARP entry expiration occurs when the ARP cache is idle, i.e. no requests or lookups 
are currently being processed. At this time, an 8-bit counter is used to cycle through 
25 and search the LUT. Each slot in the LUT is checked to see if it contains a valid 
pointer. If a pointer is valid, the memory block pointed to is retrieved. Then, each 
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entry within that block is checked to see if the difference between its timestamp and 
the current time is greater than or equal to the maximum lifetime of an ARP entry. If 
other memory blocks are chained off the first memory block, the entries contained in 
those blocks are also checked. Once all the entries associated with a given LUT 
5 index have been checked, then the next LUT slot is checked. 

If an entry is found to have expired, the valid bit in the entry is set to zero. If there 
are no other entries within the same memory block, then the block is de-allocated 
and returned to mallocl . If the block being de-allocated is the only block associated 
10 with a given LUT slot, the PV bit in that slot is also set to zero. 

Performing ARP Proxying 

The ARP cache supports proxy ARP entries. ARP proxying is used when this device 
15 acts as a router for LAN traffic, or there are devices on the LAN that are unable to 
respond to ARP queries. 

With ARP proxying enabled, the ARP module passes requests for IP addresses that 
do not belong to the host up to the ARP cache. The ARP cache then does a lookup 

20 to search for the target IP address. If it finds a match, it checks the type field of the 
ARP entry to determine if it is a proxy entry. If it is a proxy entry, the ARP cache 
passes the corresponding Ethernet address back to the ARP module. The ARP 
module then generates an ARP reply using the Ethernet address found in the proxy 
entry as the source Ethernet address. Note: ARP proxy lookups occur only for 

25 incoming ARP requests. 
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When the system (host computer plus IT 10G hardware) initially connects to a 
network, the user or application running on the host computer should perform a 
5 gratuitous ARP request to test if any other device on the network is using one of the 
IP addresses assigned to its interface. If two devices on the same LAN use the 
same IP address, this could result in problems with routing packets for the two hosts. 
A gratuitous ARP request is a request for the host's own IP address. If no replies 
are received for the queries, then it can be assumed that no other host on the LAN is 
1 0 using our IP address. 

An ARP check is initiated in a manner similar to that of performing an ARP lookup. 
The only difference is that the cache is discarded once the gratuitous ARP request 
has been completed. If no replies are received, the entry is removed. If a reply is 
15 received, an interrupt is generated to notify the host computer that the IP address is 
in use by another device on the LAN, and the entry is removed from the cache. 

Cache Access Priorities 

20 Different tasks have different priorities in terms of access to the ARP cache memory. 
Proxy entry lookups have the highest priority due to the need for rapid responses to 
ARP requests. Second in priority is adding dynamic entries to the cache; incoming 
ARP packets may be received at a very high rate and must be processed as quickly 
as possible to avoid retransmissions. ARP lookups from the IP router have the next 

25 highest priority, followed by lookups by the host computer. The manual creation of 
ARP entries has the second lowest priority. Expiring cache entries has the lowest 
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priority and is performed whenever the cache is not processing an ARP lookup or 
creating a new entry. 



IP Module 

5 

Overview 

The IT 10G natively supports IPv4 packets with automatic parsing for all types of 
received packets. 

10 

IP Module Block Diagram 

Figure 16 is a block schematic diagram of one implementation of an IP Module 
Block. 

15 

IP Sub Module Descriptions 
IP Parser 

20 The IP Parser module 161 is responsible for parsing received IP packets and 
determining where to send the packet. Each received IP packet can be sent to 
either the TCP/UDP module or the exception handler. 

IP Header Field Parsing 

25 
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IP Version 

Only IPv4 are accepted and parsed by the IP module, therefore this field must be 
0x4 to be processed. If an IPv6 packet is detected, it is handled as an exception and 
5 processed by the Exception Handler. Any packet having a version that is less then 
0x4 is considered malformed (illegal) and the packet is dropped. 

IP Header Length 

10 The IP Header Length field is used to determine if any IP options are present. This 
field must be greater then or equal to five. If it is less, the packet is considered 
malformed and dropped. 

IPTOS 

15 

This field is not parsed or kept for received packets. 
Packet Len 

20 This field is used to determine the total number of bytes in the received packet, and 
is used to indicate to the next level protocol where the end of its data section is. All 
data bytes received after this count expires and before the ip_packet signal de- 
asserts are assumed to be padding bytes and are silently discarded. 

25 Packet ID, Flags, and Fragmentation Offset 
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These fields are used for defragmenting packets. Fragmented IP packets may be 
handled by dedicated hardware or may be treated as exceptions and processed by 
the Exception Handler. 

5 TTL 

This field is not parsed or kept for received packets. 
PROT 

10 

This field is used to determine the next encapsulated protocol. The following 
protocols are fully supported (or partially supported in alternative embodiments) in 
hardware: 

15 Table 4 Supported Protocol Field Decodes 



Hex 
value 


Protocol 


0x06 


TCP 


0x11 


UDP 



If any other protocol is received, and if the unsupport_prot feature is enabled, then 
the packet may be sent to the host computer. A protocol filter may be enabled to 
selectively receive certain protocols. Otherwise, the packet is silently discarded. 

20 

Checksum 
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This field is not parsed or kept. It is used just to make sure the checksum is correct. 
If the checksum turns out bad, then the bad_checksum signal, which goes to all the 
next layers is asserted. It stays asserted until it is acknowledged. 

5 Source IP Address 

This field is parsed and sent to the TCP/UDP layers. 

Destination IP Address 

10 

This field is parsed and checked against valid IP addresses that the local stack 
should be responding to. This may take more then one clock cycle, in which case 
the parsing should continue. If the packet turns out to be misdirected, then the 
bad_ip_add signal is asserted. It stays asserted until it is acknowledged. 

15 

IP ID Generation Algorithm 

The on-chip processor can set the IP ID seed value by writing any 16-bit value to the 
IP_ID_Start register. The ID generator takes this value and does a mapping of the 
20 16 bits to generate the IP ID used by different requestors. The on-chip processor, 
TCP module, and ICMP echo reply generator can all request an IP ID. A block 
diagram of one implementation of the ID generator is shown in the Figure 17. 

The IP ID Seed register is incremented every time a new IP ID is requested. The Bit 
25 Mapper block rearranges the IP_ID_Reg value such that the IP_ID_Out bus is not a 
simple incrementing value. 
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IP Injector Module 

The IP injector module is used to inject packets from the on-chip processor into the 
5 IP and TCP modules. The IP injector control registers are located in the IP module 
register space, and these registers are programmed by the on-chip processor. A 
block diagram depicting the data flow of the IP Injector is shown in Figure 18. 

As can be seen, the IP Injector is capable of inserting data below the IP module. To 
10 use IP Injection, the on-chip processor programs the IP Injectior module with the 
starting address in its memory of where the packet resides, the length of the packet, 
and the source MAC address. The injector module generates an interrupt when it 
has completed transmitting the packet from the on-chip processor's memory into the 
stack. 

15 

TCP / UDP Module 
Overview 

20 This section describes the TCP module, which handles the TCP and UDP transport 
protocols. The TCP module is split into four main sections; the Socket Transmit 
Interface, the TCP Transmit Interface, the TCP Receive Interface, and the Socket 
Receive Interface. 

25 Feature List 
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64K Socket Support 



TCP Out Of Order Support 



Slow Start 



Fast Retransmission / Fast Recovery 



Selectable Nagle Algorithm 



Window Scaling 



Selective ACKs (SACK) 



Protection against wrapped seq 



numbers (PAWS) 



Time Stamp Support 



Keep Alive Timers 



Window Scaling 



The IT 10 G supports Window Scaling. Window scaling is an extension that expands 
the definition of the TCP window to 32 bits. It is defined in RFC1323 section 2 (see 
http://www.rfc-editor.org/rfc/rfc1323.txt ). The window scale operation is based 
on three variables. One is the SL_Win_En bit of TCP_Control1 (this enables window 
10 scale), two is the sliding window scale bits in TCP_Control3 (this sets the scaling 
factor), and finally the WCLAMP parameter determines what the value to be scaled 
is. 

Without the SL_Win_En bit the hardware will not try to negotiate window scaling via 
1 5 the TCP Window scale option during the TCP 3-way handshake. 

TCP Dump Mode 

TCP dump mode is an IT 10G hardware mode that allows support for widely used 
20 diagnostic programs such as TCPdump and other packet monitoring programs. 
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When TCP dump mode is enabled all received packets are sent as exceptions to the 
host and all outgoing TCP/UDP packets coming from the hardware stack are looped 
back as exception packets. 

5 A driver would make copies of these packets for the network monitor and re-inject rx 
packets and sending TX packets as raw Ethernet frames. 

Host ACK Mode 

10 Host ACK mode is a IT 10G hardware mode that only sends a TCP ACK when the 
host computer has received the data from a TCP segment. Host ACK mode waits 
for the DMA of the MTX buffer that contains the data segment to complete before 
sending the ACK. Host ACK mode provides for additional data integrity in the case 
that data may be corrupted as it is passed between host computer and the integrated 

1 5 network adapter or vice versa. 

Timestamps 

The IT 1 0G provides support for Timestamps. Timestamps are an enhancement to 
20 TCP defined in RFC1323 (see http://www.rfc-editor.org/rfc/rfc1323.txt ). Timestamps 
allow TCP to better calculate the RTT (Round Trip Time) measurement and are also 
used to support PAWS (Protect Against Wrapped Sequences.) 

PAWS 

25 
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PAWS (Protect Against Wrapped Sequences) is defined in RFC1323 (see 
http://www.rfc-editor.org/rfc/rfc1323.txt ). PAWS protects against old duplicate 
segments corrupting TCP connections, which is an important feature for high-speed 
links. 

5 

TCP Host Retransmit Mode 

TCP host retransmit mode allows the retransmission of data directly out of the host's 
memory buffers instead out of buffers located in thre integrated network adapter. 
10 This permits the amount of memory required by the integrated network adapter to be 
reduced. 

Initial Sequence Number Generation 

1 5 The initial sequence number generator needs to be secure. RFC1 948 points out the 
weakness in the original initial sequence number specification in RFC793 and 
recommends several replacement methods. The integrated network adapter uses 
an optimized method that works according to RFC1948 but is efficient to implement 
in hardware. 

20 

Dual Stack Mode 

Dual stack mode allows the hardware TCP/IP stack integrated into the network 
adapter to work in cooperation and in conjunction with a software TCP/IP stack in the 
25 host computer. 
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Dual stack mode allows the integrated network adapter to support the co-existence 
of a software stack running in parallel using the same IP address(es) as the 
integrated network adapter. 

5 Dual stack mode requires two basic hardware functions in the integrated network 
adapter. The first hardware function is the SYN status message mode. In the SYN 
status message mode any received SYN will generate a status message back to the 
host computer, and the SYN/ACK is not generated by the integrated network adapter 
hardware until the host computer sends the proper instruction block back to the 

10 integrated network adapter hardware. If the SYN status message mode is not 
enabled on integrated network adapter, then SYN/ACKs are generated automatically 
by the integrated network adapter and SYN received status messages are not 
generated. 

15 The second hardware function required by dual stack mode is the suppression of 
RST messages from the integrated network adapter hardware when a TCP packet 
is received that doesn't match the integrated network adapter control block 
database. In this case, instead of automatically generating a RST the integrated 
network adapter hardware should send the packet to the host computer as an 

20 exception packet to allow the software TCP/IP stack in the host computer to handle 
this packet as an exception packet. 

IP ID Splitting 

25 IP (Internet Protocol) ID (Internet Identification) splitting is part of the dual stack 
support package. IP ID splitting allows the host computer and the integrated network 
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adapter to share an IP address without overlapping IP ID's. When IP ID splitting is 
turned off the integrated network adapter uses the full 16 bit ID range (0-255). 
When IP ID splitting is turned on, bit [15] of the IP ID is forced to a 1 allowing the 
host computer software TCP/IP stack to use half of the IP ID range (i.e. the 
5 integrated network adapter will use 128-255 while the host computer software 
TCP/IP stack can use 0-127 for IP ID). 

Custom Filtering 

10 There are several places in the hardware that have custom filters that can be used to 
restrict, accept or take special action on certain types of packets. Ethernet filtering 
can take the following attributes: 

• Accept a programmed uni-cast address 

• Accept broadcast packets 
15 • Accept multicast packets 

• Accept addresses within a range specified by a netmask 

• Promiscuous mode (accepts all packets) 

VLAN Support 

20 

VLAN support consists of several optimized hardware elements. One hardware 
element strips the incoming packets of their VLAN headers, a second optimized 
hardware element generates VLAN tagged outbound packets, a third optimized 
hardware element generates VLAN parameters from incoming SYN frames, and a 
25 fourth optimized hardware element passes VLAN tag information for exception 
packets and UDP packets. 
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Jumbo Frame Support 

Jumbo frames are larger than the normal 1500-byte sized Ethernet frames. Jumbo 
5 frames less of the network bandwidth to be used for header information, which 
allows increased data throughput in the network. The Integrated network adapter 
uses optimized hardware to support jumbo frames of up to nine kbytes. 

SNMP Support 

10 

SNMP is a form of upper-level protocol that allows statistics of network and hardware 
adapter performance to be monitored remotely. 

MIB Suport 

15 

The integrated network adapter contains optimized hardware support for many 
statistics counters. These statistics counters are defined by a standard management 
information base (MIB). Each of these SNMP MIB counters track events that occur in 
the network and in the integrated network adapter (packets received, transmitted, 
20 dropped and so forth). 

Memory Checking 

Memory error checking and correction (ECC) is similar to parity checking. However, 
25 where parity checking can only detect single-bit errors, ECC can detect and correct a 
single-bit memory errors and detect double-bit errors. 
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Single-bit errors are the most common and are characterized by a single bit of data 
being incorrect when reading a complete byte or word. A multi-bit error is the result 
of more than one bit being in error within the same byte or word. 

5 

ECC memory uses extra bits to store an encrypted ECC code with the data. When 
the data is written to memory, the ECC code is also stored. When the data is read 
back, the stored ECC code is compared to the ECC code which would have been 
generated when the data was written. If the ECC codes don't match we can 
10 determine which bit in the data is in error. The bit in error is "flipped" and the memory 
controller releases the corrected data. Errors are corrected "on-the-fly," and 
corrected data is not placed back in memory. If the same corrupt data is read again, 
the correction process is repeated. 

1 5 The Integrated network adapter allows ECC to be programmed and selected in a flexible 
manner to protect both packet data and control information within the adapter. 

Legacy Mode 

20 Legacy modes allows all network traffic to be sent to the host computer regardless of 
traffic type. These modes allow the integrated network adapter to operate as if the 
hardware TCP/IP stack were not present in the adapter, a mode often referred to as 
a dumb NIC (network interface card). 

25 IP Fragmentation 
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Reassembly of IP fragmented packets does not have handled by the integrated 
network adapter. The IP fragmented packets passed up as exception packets and 
reassembled in the driver then "re-injected" via the IP injection mode back into the 
integrated network adapter. 

5 

IP Injection 

The IP injection mode allows IP packets (for example re-assembled IP fragments or 
IPsec packets) to be injected into the hardware TCP/IP stack in the integrated 
10 network adapter. 

The injection control registers are used to inject an IP packet into the hardware 
TCP/IP stack within the integrated network adapter. The injection control registers 
feature allow the host computer to control the injection and inject an IP packet into 
15 the hardware TCP/IP stack within the integrated network adapter. The injection 
control registers thus allow the injection of SYN, IPSec or other packet into the 
integrated network adapter. The injection control registers are also part of the TCP 
dump mode functionality. 

20 NAT, IP masquerading, and port forwarding 

NAT, IP masquerading, and port forwarding are supported in the integrated network 
adapter via port range registers that forward all packets of a specified type UDP or 
TCP that fall in a programmable range of ports to the exception path. The port 
25 registers enable certain ranges of ports to be used for network control operations 
such as NAT, IP masquerading, and port forwarding. 
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Multiple IP Addresses 

The integrated network adapter hardware supports up to 16 ranges of IP addresses 
5 that it can respond to as its own IP address. These address ranges are accessible 
as IP address base with a mask. This allows an IP address to be extended to a 
range of IP addresses. This allows the integrated network adapter to perform multi- 
homing or the ability to respond to multiple IP addresses. 

10 IP Debug Mode 

When a test and control bit is enabled in the integrated network adapter, all IP packets 
are sent as exceptions to the host computer. This mode is designed for diagnostic 
purposes. 

15 

Time Wait State 

Time wait is the final state of a passive mode TCP connection, the time wait state 
and it's operation are described in RFC793, see http://www.rfc- 
20 editor.org/rfc/rfc793.txt 

Virtual Sockets 

The integrated network adapter hardware supports a variable number of sockets or 
25 connections; the current implementation supports up to 645535 sockets. 
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Integrated network adapter that provides optimized hardware support (which is 
integrated with TOE) for transfer of connections between adapter and host computer 



When the integrated network adapter hardware accepts a connection that equals it's 
5 maximum capacity the next SYN is passed up to the host as an exception packet so 
the host will be able to handle this connection. Note that in this case for the host to 
open up this connection we need to set the hardware to use part of the dual stack 
mode that allows TCP packets that don't match the hardware's database to be 
passed up to the host as an exception packet instead of replying with a RST. 

10 

Time to Live 

TTL or time to live is an IP address parameter that limits the life of an IP packet on 
the network to a number of hops (a hop is a jump across a layer 3 device such as a 
1 5 router). The integrated network adapter hardware sets this value for outgoing frames 
to limit the time to live of the transmitted packet. See RFC791 section Time To Live 
at http://www.faqs.ora/rfcs/rfc791.html for more information. 

Keepalive 

20 

Keepalive is an enhanced function of TCP described in RFC1122 section 4.2.3.6. 
See http://www.f a gs.org/rfcs/rfc1 1 22.html . Keep alive allows an idle TCP connection 
to stay connected and not time out by periodically sending a keep alive packet 
across the link. 

25 

ToS 
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TOS or type of service is an IP address parameter that can be used by routers to 
prioritize the IP packet. The TOS parameter needs to be adjustable at a system and 
socket layer. On transmit the integrated network adapter hardware sets TOS via 
5 several registers. See RFC791 section Type of Service at 
http://www.faqs.ora/rfcs/rfc791.html for more information. 

QoS 

1 0 The integrated network adapter hardware supports four transmit queues to allow QoS 
for transmitted data. Each socket can be assigned a QoS value. This value also 
can be used to map onto VLAN priority levels. 

A summary of the transmit operation is as follows. The TCP transmit data flow starts 
15 with the Socket Query module, which goes through the transmit data available Bit 
table looking for entries that have their Transmit Data Available bits set. When it 
finds such an entry, then the Socket Query module puts that entry into one of the 
four queues according to the socket's User Priority level. Sockets with priority level 7 
or 6 will get put into Queue List 3, levels 5 and 4 will get put into Queue List 2, levels 
20 3 and 2 will get put into Queue List 1 , and levels 1 and 0 will get put into Queue List 
0. 

These QoS features using priority queues allow parallel use of multiple hardware 
modules depending on transmit traffic. 

25 

Failover 
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Failover between network adapters is supported by NO_SYN mode. NO_SYN mode 
allows a socket to be created without trying to initiate a connection. This allows a 
socket and all its related data structures in the integrated network adapter hardware 
5 to be created without creating a connection. The NO_SYN mode allows the support 
of failover from another card or connection migration from a software TCP/IP stack to 
the integrated network adapter. 

Top Level Block Diagram 

10 

Figure 1 9 depicts the top-level block diagram of one implementation of the TCP 
module. The Socket Control Blocks (CBs) 191 contain the information, state, and 
parameter settings that are unique to each socket connection, and form the most 
important or key part of the virtual socket (VSOCK) architecture. A locking 
15 mechanism is installed such that while one module is operating on a CB, no other 
module can be operating on it. 

TCP Receive Sub Module 

20 Figure 20 depicts the TCP Receive 200 data flow. 
Overview 

For normal IP traffic, a packet is received via the 64-bit TCP Rx data path. The 
25 packet header goes to the TCP Parser module, and the packet data is routed to the 
Rev Data Memory Controller 201 . For IP fragmented traffic, data is received via 
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memory blocks while header information is received via the normal path. This allows 
the memory blocks from IP fragmentation to look similar to the data blocks written by 
the Rev Data Memory Controller. CPU data also use the memory blocks to inject 
received data via the Rev Data Memory Controller. This architecture gives maximum 
5 flexibility in handling normal and fragmented traffic, which allows performance to be 
optimized for normal traffic while still supporting fragmented traffic. 

The Rev TCP Parser 202 is responsible for parsing the header information and 
passing parameters to the VSOCK 203 and Rev State Handler 204. If the Rev TCP 
10 Parser does not know what to do with the data, it passes it to the Exception Handler 
205. In addition, the Rev TCP Parser can also be programmed to send all data to 
the Exception Handler. 

The VSOCK module takes the local and remote IP and port addresses and returns a 
15 pointer to a Control Block. 

The NAT & IP Masquerading module 206 determines if the received packet is a NAT 
or IP Masquerading packet. If it is, the packet is passed up to the Host System in a 
raw (complete packet) format. 

20 

The Rev State Handler keeps track of the state of each connection and updates its 
Control Block, accordingly. 

Rev TCP Parser 

25 
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The Rev TCP Parser registers and sends packet header information to the other 
modules in the TCP receive portion of the IT 10G netork stack. The Rev TCP Parser 
module also contains the registers needed to inject data in the Rev stream from the 
CPU (the on-chip processor or host computer). The CPU must setup a memory 

5 block, then program the Rev TCP Parser registers with the information. The Rev 
TCP Parser creates a partial checksum of the TCP header, adds this partial 
checksum it to the partial checksum from the Rev Data Memory Controller, and 
compares the resulting complete checksum to the checksum in the TCP header. For 
a fragmented packet, the Rev TCP Parser checks the checksum in the TCP header 

10 against the checksum sent by the IP Fragmentation in the last fragment. 

Note: the IP module must set the IP Fragmentation bits and insert the First Mem 
Block Pointer, Last Mem Block Pointer, Index, and Partial Checksum into the data 
stream of the appropriate packet fragment. Also, TCP Rev needs the IP protocol 
1 5 information to calculate the pseudo header. 

Rev Data Memory Controller 

The Rev Data Memory Controller transfers data from the 64-bit bus between the IP 
20 and TCP modules to Data Memory Blocks in Rx DRAM. There are two modes of 
transfer. Normal mode is used to store TCP data into Memory Blocks. Raw mode is 
used to store entire packets into Memory Blocks. Raw mode is used for NAT/IP 
Masquerading. For exception handling, Normal mode is used along with registers to 
transfer CB data to the CPU. 

25 

VSOCK 
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The VSOCK module is passed the local and remote IP and port addresses from the 
packet, and returns the socket Open or TIME_WAIT (TW) Control Block (CB) pointer 
to the Rev State Handler. VSOCK performs a hash calculation on the IP and port 
5 addresses and generates a hash value that serves as an index into the Open/TW CB 
Look-Up Table (LUT) 207. The LUT entry at that location holds a pointer to an Open 
208 orTW 209 Control Block. 

The pointer from the Open/TW CB LUT points to the first Control Block of a linked list 
10 of zero or more CBs, each with different IP and port addresses, but which result in 
the same hash number (resulting from hash collisions). VSOCK goes down this 
chain, comparing the packet IP and port addresses to the entries in the chained CBs, 
until a match is found or the end of the chain is reached. If a match is found, a 
pointer to the CB is passed to the Rev State Handler. If the end of the chain is 
1 5 reached, VSOCK informs the TCP Parser of the error. 

The chain of CBs connected to the Open/TW CB LUT entry contains Open CBs and 
TIME_WAIT CBs. The Open CBs are first in the chain. There is a maximum 
number of Open CBs, as determined by RcvTCPMaxOpenCBperChain. TW CBs 

20 are chained after the Open CBs. There is also a maximum number of TW CBs per 
chain. An Open CB is created when the three-way handshake completes, and a HO 
CB is moved to the Open CBs by the Rev State Handler. A TW CB is created from 
an Open CB by the Rev State Handler when the last ACK is sent in the FIN 
sequence. If there is no more room in either case, an error is returned to the Rev 

25 State Handler. 
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A CB cache for Open CBs is implemented for Open CBs further than a preset 
number of links from the LUT entry. A bit in the CB is set when it is in the Cache. 
The Cache is searched in parallel to the hash/LUT operations. Figure 21 shows the 
VSOCK/Rcv State Handler Control Block Search Resolution Flow. 

5 

Rev State Handler 

If a SYN is received, an 12-bit hash is performed in addition to invoking VSOCK 
(which performs a 17-bit hash and searches for an Open or TIME_WAIT Control 

10 Block), and the destination port is checked against an Authorized Port List. If the 
port is allowed and VSOCK does not find a matching Open/TW CB, the hash result 
is used as an index into the HO CB Table. If VSOCK finds a matching Open or 
TIME_WAIT CB, a Dup CB error may be sent to the host computer and the SYN is 
dropped. If there is already an entry in the HO CB Table with different IP and Port 

15 addresses, the new packet info overwrites the old information. This allows resources 
to be conserved in SYN flood Denial of Service (DOS) attack. Overwriting eliminates 
the need for aging the HO CB Table. Connections that have already been 
SYN/ACKed could be silently dropped. The pointer to the CB is passed to the Rev 
State Handler. Only connections that have been opened by the remote side (local 

20 side receives SYN, not SYN/ACK) are entered in the HO CB Table. Connections 
opened by the local side are tracked by Open CBs. 

If an ACK is received, a 12-bit hash is performed and VSOCK is invoked. If there is 
a hit in the HO CB via the 12-bit hash, but VSOCK does not find an Open or TW CB 
25 and if the sequence and ack numbers are valid, then the three-way handshake for 
the connection is complete, and the CB is transferred to the Open CB table by the 
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Rev State Handler. If VSOCK does find an Open or TW CB, but there is no match 
with the 12-bit hash, then the ACK is checked for valid sequence and ACK numbers 
by the Rev State Handler, as well as for duplicate ACKs. 

5 Once the VSOCK module finds the right socket CB, then other pertinent information 
is read and updated by the Receive State Handler. TCP data are stored into large 
(2k bytes) or small (128 bytes) memory buffers. A single segment may span 
memory buffers. If one size of buffer runs out, the other size is used. When data are 
received for a given socket, its Data_Avail bit in the socket Hash LUT is also set. 

10 

If the Rev State Handler determines that a RST packet is needed, then the Rev State 
Handler forwards the appropriate parameters to the RST generator 210. If a 
SYN/ACK or ACK is needed, the Rev State Handler sends the CB handle to the RX 
toTXFIFO buffer 211. 

15 

RST Generator 

The RST Generator takes the MAC address, the four socket parameters, and 
sequence number received in the packet that needs a RST response, and builds a 
20 RST packet. The RST Generator first requests a block from MTX memory in which 
to build the packet. Because RST packets are always 40 bytes long, these packets 
fits in any size MTX block. The RST generator always requests the smallest block 
available, normally a 128 byte block. RST packets have their IP ID fixed at 0x0000 
and their DF bit set in the IP header (do not fragment bit). 

25 
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After the RST Generator builds the RST packet, the RST Generator stores the 
starting address of the MTX block containing the RST packet in a RST transmit 
queue. This queue is built in M1 memory. A block of M1 memory is requested and 
used until it is full. The last entry in each M1 block points to the address of the next 

5 M1 block to be used. Therefore, the RST queue can grow dynamically. The RST 
generator accesses M1 memory 32 bits at a time because MTX block addresses are 
only 26 bits. This queue length can grow as much as M1 memory is available. If no 
more memory is available for the queue, then the RST generator silently discards 
RST packet requests from the RCV State Handler. This has the network affect akin 

10 to dropping the RST packet in transmission. Because the connection is non-existent 
anyway, this does not have a serious affect on performance. 

The output of the RST transmission queue is fed to the TCP Transmit Packet 
scheduler. When the transmit scheduler indicates back to the RST generator that 
1 5 the RST packet has been sent, then the MTX block that was being used for that RST 
packet is released. When all the entries in a M1 memory block are sent, and the link 
address to the next M1 block has been read, then the M1 memory block is released. 
The basic data flow is depicted in the Figure 22. 

20 RX to TX FIFO Buffer 

The RX to Tx FIFO Buffer is used to queue SYN/ACK and ACKs that the RCV State 
Handler determines need to be sent in response to packets received. The RCV 
State handler passes the following information into the RX to Tx FIFO Buffer: 

25 

• The CB Address containing the socket information (16 bits) 
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• The CB type (2 bits; 00 = Half-Open, 01 = Open, 10 = Time_Wait) 

• The Message type to be sent (1 bit, 0 = SYN/ACK, 1 = ACK) 



Each RX to Tx FIFO Buffer entry is four bytes long and is stored in the 
5 miscellaneous memory buffer. Currently, this buffer is allocated 4K bytes, which 
provides a RX to Tx FIFO Buffer depth of 1K entries. The output of the RX to Tx 
FIFO Buffer is fed to the SYN/ACK Generator. 

SYN/ACK Generator 

10 

The SYN/ACK Generator 212 takes information output from the RX to TX FIFO 
Buffer, and looks up the other pertinent information from the specified CB, either 
Half-Open, Open, or Time_Wait, and then builds the desired packet, either a 
SYN/ACK or ACK. The SYN/ACK Generator first requests a block from MTX 
15 memory in which to build the packet. Because SYN/ACK and ACK packets are 
always 40 bytes long, these packets always fit in any size MTX block. The 
SYN/ACK generator always requests the smallest block available, normally a 128 
byte block. 

20 After the SYN/ACK generator builds the SYN/ACK or ACK packet, the SYN/ACK 
Generator puts the starting MTX block address into a 16-deep queue that then feeds 
the TCP Transmit Packet scheduler. If the RX to TX FIFO Buffer passes a 
programmable high watermark, then the Transmit Packet scheduler is notified of the 
situation and increases the sending priority of these packets. 

25 

NAT and IP Masquerading 
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The NAT and IP Masquerading block 206 works in parallel with the VSOCK module. 
The NAT and IP Masquerading block decodes the incoming packet to see if it is in 
the pre-specified NAT or IP Masquerading port range. If it is, then a signaling 
5 mechanism is used to indicate to the VSOCK block that it is a NAT packet. When 
this occurs, then entire packet is stored as is in the receive memory buffer. The 
packet, in turn, is transferred to the host system at some point. The driver in the host 
system is then responsible for performing routing functions, replacing header 
parameters and sending it to the proper network interface. 

10 

Exception Handler 

The Exception Handler sends packets to the host computer that are not handled by 
the IT10G core. 

15 

Support Circuits 
rset Generation 

20 A rst signal is generated from the top-levl rset signal synchronously. 
tcp_in_rd Generation 

tcp_in_rd is used to freeze the input data from IP. This is asserted when a DRAM 
25 write request is not granted immediately. It also occurs if the DRAM runs out of 
small or large memory blocks. 
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Word Counter 

The word counter, word_cnt[12:0], is zero at reset and at software reset. It 
5 increments when tcp_jn_rd is active and ip_in_eof is not. It is zero during the first 
word of ip_in_data[63:0], one during the second, etc. It goes to zero on the first word 
after ip_in_eof and remains zero between valid ip_in_data words. 

Memory Block Control Circuit 

10 

Reserve Memory Blocks 

The Memory Block Control Circuit keeps a small and a large memory block available 
for use at all times. This assures that there is little delay when data must be written 
15 into a memory block. The Memory Block Control Circuit also performs the block 
requests in parallel with the data writes. These reserve memory blocks are initialized 
out of reset. 

Initialization and Memory Block Size Selection 

20 

Parameters for the TCP or UDP segment are initialized. The size of the memory 
block to be used is determined by the TCP length info from IP and the TCP header 
length information from the Parser. If the data size (TCP length - TCP header 
length) fits into a small memory block, the reserve small memory block is used, and 
25 another small memory block is requested to refill the reserve. Otherwise, the 
reserve large memory block is used, and another large memory block is requested to 
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refill the reserve. If a small memory block is not available, a large memory block is 
used. However, if a large memory block is needed but not available, small memory 
blocks are not used. 

5 Writing Aligned TCP Data to Memory Block 

Data in a TCP packet is aligned if there are an odd number of option half-words 
(each 32 bits wide) in the TCP header, resulting in data that starts on a 64-bit 
boundary. If the TCP packet data is aligned, the TCP packet data may be placed 

10 directly into the Memory Blocks as the data is sent from the IP block. The address of 
the first block for the segment is sent to the TCP State Machine. A count is kept of 
the space remaining in the block, as well as the data left in the TCP segment. A 
record must also be kept if a Memory Block has already been filled. When the end 
of the TCP segment is reached, if a previous block was filled, then that block must 

15 be linked to the current block. Also, the link in the current block header is cleared, 
and the data length and running checksum of the data is written to the block header. 
The data length is a function of the number of bytes in the last 64-bit word, as 
determined by the bits in ip_in_bytes_val. If the block runs out of room before the 
end of the TCP segment, then the data length and running checksum are written to 

20 the block header, and a flag is set indicating that a block has been finished. The 
remaining data in the TCP segment is used to determine whether the large or small 
reserve memory block is used. The same rules as in the earlier description are used 
if a block size runs out. The address of the last memory block must be sent to the 
TCP State Machine. 

25 

Writing Unaligned TCP Data to Memory Block 
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If the data in the TCP segment is unaligned (ip_in_data[63:0] contains data that go 
into two different memory block writes) then there must be an extra cycle at the 
beginning to store the first lo 32-bit half-word from the IP block, so that the data can 
5 be written as the high 32-bit half-word in the Memory Block. The high 32-bit half- 
word in the next bus cycle from the IP block is written as the low 32-bit half-word in 
the same cycle as the stored half-word. The counts and checksum calculations must 
also be adjusted to handle this sutuation. Otherwise, unaligned data is handled in 
the same way as aligned data, with the same termination cases as already 
1 0 described. 

Writing UDP Data to Memory Block 

UDP data is always aligned, so UDP data is handled in the same way as TCP 
15 aligned data. The same termination cases apply. 

Checksum Calculation 

The checksum is calculated as described in RFC 1071. In the Checksum 
20 Calculation block, the checksum is only calculated on the data. The Parser 
calculates the header checksum, and the TCP State Machine combines the two 
checksums and decides what to do with a packet with a checksum error. 

25 

Parsing Of Fixed Header Fields 
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Word Counter 

The word counter, word_cnt[12:0], is zero at reset and at software reset. The 
5 counter increments when tcp_in_rd is active and ip_in_eof is not. The counter is 
zero during the first word of ip_in_data[63:0], one during the second, etc. The 
counter goes to zero on the first word after ip_in_eof and remains zero between valid 
ip_in_data words. 

1 0 Latches for remote_ip_add[31 :0] and local_ip_indx[3:0] 

These latches are zero at reset and software reset. remote_ip_add is latched from 
src_ip_add[31 :0] when src_ip_add_valid, ip_in_dav, and tcporudp_packet are 
asserted. Local_ip_indx is latched from dest_ip_index[3:0] when 
15 dest_ip_index_valid, ip_in_dav, and tcporudp_packet are asserted. Both are valid 
until reloaded at the next packet. 



Table 5 Fields Latched vs. Word Count 



Word 
Count 


Latched Fields 


0000 


rx_remote_port, rxJocaLpc-rt, rx_tcp_seq_num, rx_udp_length, 
rx_udp_checksum 


0001 


rx_tcp_ack_num, rx_tcp_header_len (5), rx_tcp_urgent_flg, 
rx_tcp_ack_flg, rx_tcp_push_flg, rx_tcp_reset_flg, 
rx_tcp_syn_flg, rxjcp_final_flg, rx_tcp_window_siz 


0002 


rx_tcp_checksum, rx_tcp_urgent_ptr 
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Note: fields are cleared or initialized (in parentheses) on reset and on first word from 
IP 

Note: latches are also qualified by tcp_packet, udp_packet & ip_in_dav 

5 

Checksums, Error Checks and Parsing of Optional Header Fields 
Checksums 

10 

The RFC 1071 checksum is calculated on the header as defined in the header length 
field, along with the pseudo header comprising the IP source address, the IP 
destination address (not index), the 8-bit type field with 8-bit leading zeros (= 0006 
hex), and the TCP length. 

15 

Header Length Check 



Once the rx_tcp_hdr_len field is parsed (Word Count > 0001), the rx_tcp_hdr_len 
field can be checked. The rx_tcp_hdr_len field cannot be less than five or more than 
20 MAX_HDR_LEN, which is set to ten. If so, the error_rx_tcp_hdr_len signal is 
asserted and remains so until the start of the next packet. 



TCP Length Check 



25 The IP Payload Length from IP is checked. The IP Payload Length cannot be less 
than 20 bytes (used when rx_tcp_header_len is not yet valid) and cannot be less 
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than the rx_tcp_header len. If so, the error_rx_tcp_len signal is asserted and 
remains so until the start of the next packet. 

Parsing Of Optional Header Fields 

5 

Fields are cleared on reset and on first word from the IP block. Only the Timestamp 
(10 bytes + padding), MSS (4 bytes), and Window Scale (3 bytes + padding) are 
searched out. There can only be 20 bytes of options, so header length can only be 
10 32-bit half-words (Word Count = 0004). 

10 

Options are parsed in a straightforward manner. Options start from the second half 
of word count = 2 and are 32-bit aligned. The first byte of the option identifies the 
option type. 

15 If the Timestamp option is detected, the rx_tcp_timestamp, rx_tcp_tx_echo, and 
rx_tcp_timestamp_val are loaded. 

If the MSS option is detected, rx_tcp_remote_mss and rx_tcp_remote_mss_val are 
loaded. 

20 

If the Window Scale option is detected, rx_tcp_remote_win_scl and 
rx_tcp_rem_win_scl_val are loaded. 

These stay valid until the beginning of the next packet. 
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The Socket Receive Submodule handles the interface between the IT10G and the 
system (host computer) for received data. Figure 23 shows the Socket Receive Data 
5 Flow. 

The Socket Receive Submodule process starts with the receive logic 230 setting a 
bit in the Socket Receive DAV bitmap table 231 . The Socket Receive DAV bitmap 
table has a bit associated with each of the 64K sockets (therefore the table is 8K 
10 bytes). By knowing the location of the CB, the appropriate bit is set. 

The Socket_DAV Query module 232 is a block that is continuously scanning the 
Socket Receive DAV bitmap table. When the Socket_DAV Query module comes 
across a set bit, it generates the corresponding CB address, and checks the CB 

15 structure to see if the CB structure contains a valid linkjist block. A valid linkjist 
block consists of a 64-bit memory address, and a 16 bit length. If the CB does have 
a valid linkjist block, then the CB address, and the linkjist information is passed to 
the DMA Prep module 233 via a two-stage pipeline register pair. The SocketJDAV 
module also clears the CB's corresponding bit at that time. If the CB does not 

20 contain a valid linkjist block, then a status message is generated for the socket 
informing the host that data is available for the socket, but no valid transfer block 
information exists for that socket. In this case, the corresponding bit in the bitmap 
table is not cleared yet. The CB can also be updated in this case to that we know we 
have already sent out a status message to the host asking for a linkjist block. This 

25 step is necessary so that we do not send multiple status messages for the same CB. 
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If a valid linkjist block exists, then the next step is that the CB and transfer 
information is sent to the DMA prep module. The DMA prep module is responsible 
for reading the data from the socket data buffer and transferring the data into one of 
2 ping-pong transfer FIFO buffers 234 for the DMA engine. When this data transfer 
5 is complete, the DMA prep module sends a request to the Transmit DMA engine 235 
that there is data to be transferred. The linkjist info is also passed to the Transmit 
DMA engine. 

When the Transmit DMA engine gets a request from the DMA prep module, the 
10 Transmit DMA engine signals to the main DMA engine 236 that we wish to perform a 
DMA transfer to the host. When we are granted the bus, the DMA engine reads data 
out of the ping pong buffers and sends them to the host computer. When the DMA 
transfer is complete, the CB for the socket is updated, and a status message 
generated indicating that the data has been sent to the host computer. 

15 

The Status message generator 237 is the module that is responsible for generating 
the status messages, and writing the status messages into a status message block 
of memory (1K bytes). Status message generation requests may come from the 
Transmit DMA engine, the Socket DAV Query module, or the CPU. 

20 

Socket Transmit Sub Module 

The Socket Transmit Submodule handles the interface between the IT10G and the 
system for transmitting data. Figure 24 shows the Socket Transmit flow. 

25 
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The Socket Transmit flow starts with the reception of a command block list from the 
host. The command block list is received via a DMA transfer, and placed into the 
Command List 241 . From here blocks are extracted and parsed by the Command 
Parser module 242. Commands that are understood by the parser are executed and 
5 those that are not understood are sent to the on-chip processor. 

If the command is to transfer data, then the linkjist information is extracted from the 
command block, along with the CB address, and placed on a Transfer Queue 243. 

10 The Receive DMA engine 244 takes entries off this Transfer Queue and executes 
the data transfer from host computer memory. Data is placed into a pair of ping- 
pong FIFO buffers 245. The CB address associated with the data just received, is 
passed to the Socket Xmt Data Control module 246. 

The Socket Xmt Data Control module takes data from the ping-pong FIFO buffers 
and places the data into the Transmit Socket Data memory 248. The Socket Xmt 
Data Control module retrieves block addresses from the malloctx memory allocator 
247. The Socket Xmt Data Control module also queries the socket CB for the 
priority level of the socket. When all the data has been transferred to the data buffer, 
the Socket Xmt Data Control module puts the CB address into one of the four priority 
queues. The Socket Xmt Control module also updates the socket CB with the new 
data transmit count information. 

When data is transferred from the DMA receive FIFO buffers into socket data 
25 memory, a running checksum is performed at that time. The checksums are 
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calculated on a per block basis. This helps cuts down on transmission latencies later 
as data need not then be read again. 



CB LUT 

5 

Overview 

The TCP receive logic uses a LUT to find open socket connections. The LUT is 
128K deep by 18 bits. 

10 

CB LUT to DRAM Interface 

This section describes the interface between the miscmem module and the NS DDR 
Arbitration module. It describes the data flow, lists interface signals, and details the 
15 timing required. 

Data Flow 

The CB LUT only performs single read and write accesses to the data DRAM. In the 
20 present implementation the DRAM is external, but the memory could alternatively be 
provided on-chip. The DRAM access is in DWORDs. Because each LUT entry is 
only 18 bits, only the bottom 18 bits of the DWORD are passed to the CB LUT 
memory interface. 

i 

25 TCP Transmit Sub Module 
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The TCP Transmit Sub Module module is responsible for determining which socket 
should be serviced next for data transmission, and for updating the socket CB blocks 
accordingly. The data flow is depicted in Figure 25. 

The TCP transmit data flow starts with the Socket Query module. The Socket Query 
module scans the XMT.DAV Bit table looking for entries that have their Transmit 
Data Available bits set. When the Socket Query module finds a Transmit Data 
Available bit that is set, then the the Socket Query module puts that entry into one of 
the four queues according to the socket's User_Priority level. Sockets with priority 
level 7 or 6 are put into Queue List 3, levels 5 and 4 are put into Queue List 2, levels 
3 and 2 are put into Queue List 1 , and levels 1 and 0 are put into Queue List 0. 

These lists all feed a Packet Scheduler 251. The Packet Scheduler is responsible 
for pulling packets off of the priority cues in a non-starvation manner. The Packet 
Scheduler also arbitrates between sending data packets out, as well as SYN_ACK 
and RST packets that were generated from the Half-Open support module. 

When the Packet Scheduler determines which packet to send out next, the Packet 
Scheduler forwards this information to the Socket transmit Handler 252. The Socket 
transmit Handler module reads the socket CB information, generates the packet 
headers, updates the CBs, and sends the packet transmit information to the 
Transmit queue 253. All packet headers are generated in separate memory buffers 
which are then pre-pended to the data buffers. This also applies if the data to be 
sent start in the middle of a data buffer. In this case, the point from the packet 
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header data buffer points to the first byte of data to be sent. A locking mechanism is 
used so that this module does not modify the same socket CB that another module 
may be operating simultaneously. 

5 The Transmit Queue is responsible for queuing data packet to be sent to the master 
transmission arbitrator. 

Packet Scheduler 

10 The Packet Scheduler is responsible for determining which packet is sent out next. 
A block diagram of one implementation this module is shown in Figure 26. 

The packet scheduling process starts by the Comparator 260 taking the queue 
number that is in the current state and seeing if there is anything in that queue to be 

15 sent. The queue number can represent one of the Queue lists or a TCP Rev Packet. 
If there is a packet of that type waiting, then its entry is pulled and scheduled as the 
next transmitted packet. If there is no packet in that queue, then the state counter is 
incremented and the next queue state checked. This continues until a queue 
number matches a queue list (or TCP Rev packet) that has a packet ready for 

20 transmission, or the end bit in the state entry is set. If the end bit is set, then the 
state counter resets back to zero (0). 

The queue arbitration sequence is programmable. An application can set the queue 
arbitration sequence by first setting the Queue_State register to 0x00 and then 
25 writing the Queue number and end bit to the Queue_Entry register. There are two 
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built-in arbitration sequences which can be set by asserting either the Flat or Steep 
bits in the Queue_State register. 



Flat Sequence 

5 

The Flat Sequence is the default sequence state that the Scheduler uses after any 
reset. The Flat Sequence can also be set by writing the seq_prog field in the 
TSequence register to 01 . The sequence is shown below: 

1 0 3-2-3-2-3-X-1 -3-2-3-X-2-3-1 -3-X-2-3-2-3-0-X <repeat> 

Where 3,2,1, and 0 are the respective Queue lists and X are packets from the TCP 
Rev logic. Under this scheme each list has the following bandwidth allocation: 

15 Table 6 Flat Sequence Bandwidth 



List 


% of 




Bandwidth 


3 


49.0 


2 


27.3 


1 


9.1 


0 


4.5 


X 


18.2 



Steep Sequence 
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An alternative to the preprogrammed Flat Sequence is the Steep sequence. The 
Steep sequence weights the higher priority queues more, and is useful where many 
high priority applications are running simultaneously. The Steep sequence is set by 
writing the seq_prog field in the TSequence register to 10. The Steep sequence is 
shown below: 

3-3-2-3-3-2-X-3-3-1 -3-3-2-3-X-3-2-3-3-1 -3-3-X-2-3-3-2-3-3-0-X 
The percentage bandwidths for this sequence are as follows: 
Table 7 Steep Sequence Bandwidth 



List 


% of 




Bandwidth 


3 


58.1 


2 


19.4 


1 


6.4 


0 


3.2 


X 


12.9 



The use of the packet scheduler allows the sharing of hardware modules and 
resources depending on receive data traffic. 

Hash Algorithm 

The Hash algorithm used combines the socket's local and peer ports, and local and 
peer IP addresses to form a single 17 bit Hash value. The hash algorithm is 
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designed to be simple thereby yielding single clock cycle results, as well as being 
spread spectrum enough to minimize Hash LUT collisions. The equation of the Hash 
is as follows: 

5 LP = Local Port 
PP = Peer Port 
LIP = Local IP Address 
PIP = Peer IP Address 

10 Hash[16:0] = {({LP[7:0], LP[15:8} a PP), 1'bO} a {VbO, ((LIP[15:8] A LIP[7:0]) a 
(PIP[15:8]APIP[7:0]))}; 

The following are the steps that are performed for the Hash: 

15 • The bytes of the local port are swapped. 

• The new byte swapped local port is XOR'ed with the Peer Port to form a 1 6 bit 
Port Product. 

• The MSB of the Local IP address is XOR'ed with the LSB of the Local IP 
address. 

20 • The MSB of the Peer IP address is XOR'ed with the LSB of the Peer IP 
address 

• The two IP address products are XOR'ed to form an IP Word Product. 

• The Port Product is shifted left by one bit and filled with a 0 to form a 17 bit 
value. 

25 • The IP Word Product is appended with a leading 0 to form a 17-bit product. 
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• The new 17 bit Port Product and IP Word Product are XOR'ed to form the 
final Hash value 



This Hash algorithm is depicted in Figure 27. 

5 

The following is an example of the Hash algorithm. 

LP = 1024 
PP = 0080 
10 LIP = 45.C3.E0.19 
PIP = 23.D2.3F.A1 

Port Product = 0x241 0 A 0x0080 = 0x2490 

IP Product = (0x45C3 A 0xE019) A (0x23D2 A 0x3FA1) = 0xA5DA * 0x1 C73 = 
15 0xB9A9 

Final Hash = {0x2490, 0} A {0, 0x79A9} = 0x04920 A OxOB9A9 = 0x0F089 

For the Half Open control block LUT, a 12-bit Hash is used. This 12-bit Hash value 
20 is derived from the equation above as follows: 

Hash 12 [1 1 :0] = Hash17[16:5] A Hash17[1 1:0]; 

where Hash17 is the previously defined equation. 

25 

ISN Algorithm 
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Theory of Operation 

The ISN algorithm used in the IT10G is similar to the algorithm described in 
5 RFC1948 and incorporates a 4-microsecond based timer, a random boot value 
settable by the host system, and the four socket parameters (ports and IP 
addresses). The function has the following form: 

ISN = Timer + F(boot_value, srcjp, destjp, src_port, dest_port) 

10 

Where Timer is the 4-microsecond based 32-bit up counter. The F( ) function is 
based on a function FC( ), which is defined as follows: 

FC (hv32, data32) = [(prev32 « 8) A (prev32 » 7)] A data32 

15 

Initially, the value of hv32 is set to the random boot_value from the system (host 
computer). Then, for each ISN requested, hv32 is calculated as follows: 

hv32 = FC (prev32, srcjp) 
20 hv32 = FC (prev32, dest_ip)v 

hv32 = FC (prev32, {src_port, dest_port}) 

A block diagram for the entire algorithm is shown in Figure 28. 

25 The current architecture takes four clock cycles to compute an ISN. In the first cycle, 
the source IP address (srcjp) is fed through to generate hv32. In the second clock 
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cycle, the destination IP address is fed through, and in the third clock cycle, the port 
information is fed through. The fourth clock cycle is used to add the final function 
value with the incrementing timer value. Note also that reg A, and reg B are not 
clocked on the fourth clock cycle. 

5 

Test Mode 

An ISN test mode is provided as a way to set the ISN to a given number for 
diagnostic purposes. This test mode is used as follows: 

10 

Write 0x00 to 0x1 A06 (TCP TX Read Index Register) 

Write bits [7:0] of the ISN to 0x1 A07 

Write 0x01 to0x1A06 

Write bits [15:8] of the ISN to 0x1 A07 
15 Write 0x02 to 0x1 A06 

Write bits [23:16] of the ISN to 0x1 A07 

Write 0x03 to 0x1 A06 

Write bits [31:24] of the ISN to 0x1 A07 

Write 0x04 to 0x1 A06 
20 Write any value to 0x1 A07 (enables the test mode) 

The write in step #10 above enables the ISN test mode. The ISN now specified is 
used the next time an ISN is requested. To clear the test mode, write 0x05 to 
0x1 A06 and then write any value to 0x1 A07. 

25 

Socket Control Block Structures 

92 



WO 03/105011 



PCT/US03/18049 



Overview 

Socket control blocks or CBs contain the working information for each socket, and 
5 reside in the CB memory space. CBs contain all the state information, memory 
pointers, configuration settings, and timer settings for a socket. These parameters 
may be updated by various TCP sub-modules. A locking mechanism ensures that 
only one sub-module can modify a socket CB at a time. The IT10G uses a different 
CB structure for sockets that are in the half-open state, the established state, and the 
10 closing states. 

Established Socket Main TCP / UDP CB Structure 

The following table lists all fields in the main TCP CB structure in memory for 
15 established sockets. There is also an annex TCP CB structure that is defined below. 

Table 8 Established TCP Socket Main CB Structure 
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24 



20 



16 



12 



Remote IP address [31:0] 



Remote Port [15:0] 



IP Index [3:0] 



Local Port [15:0] 



CormSt3te[3:0] | AX SA TS ws | zw ar CF Cv RD caver j5] [ CB htwtaa F*J " SY St[sr jff OF jvi |re |ao 



ACK Number I31.-0J 



SEQ Number f31:0J 



Keep Alive Time 



LWinScate [3:0] RWinScale [3:0] 



PA Priority 



VID 111:0] 



Remote MSS [15:0] 



Remote MAC Address [47:32] 



Remoio MAC Address [31 :0] 



Locsl IP Address [31:0] 



RX ACK Number [31:0] 



Congestion Window (cwnd) [31:0J 



Sock Type 



IPSEC Mode[3:0] 



HR AS DA R0 RV TP 



MSS.S 



RX Ending Mem Block Pointer [25:0] 



RX Start Mem Block Pointer [25:0] 



Next TX Mem Block Pointer [25:0] 



Silly Window Size [29:0] 



RX DMA Count [15:0] 



Host Buffer Offset [15:0] 



Window Clamp [31:0] 



Link List Address [31:0] 



RX DMA Count [23:16] 
OupAck[£0j htitio&Pmbes (3;0J 



Socket Channel [7:0] 



Link List Entries [7:0] 



Transfer Threshold [1S.-0] 



1ZZA 



TX Data AvaB |23:0] 



RX Window Size 115:0] 



Next CB Link [15:0] 



IP TTL [7:0] 



IPTOS[7:0] 



RX Timestamp / Timed Seq Number [31:0] 



Smooth Mean Dev. (D) [31:0] 



Stow Start Threshold (ss thresh) 



Smooth RTT(A)[31:0] 



Retransmission Timeout (RTO) [31:0] 



Retransmission Timestamp [31:0] 



TX Left SACK [31:0] 



TX Right SACK [31:0] 



RX Left SACK [31:0] 



RX Right SACK [31:0] 



Established Socket Main CB Field Definitions 
Remote IP Address (Address 0x00, 32 bits) 

This 32-bit field represents the remote IP address for the connection. For client 
sockets, this field is set by the application. For server sockets, this field is filled in by 
the IP address received in the SYN packet or the IP address in the received UDP 
packet. 
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This field represents the remote port number for the connection. For client sockets, 
this field is always specified by the application. For server sockets, this field is 
always filled in with the port number received in the SYN or UDP packet. 

Local Port (Address 0x01 [15:0], 16 bits) 

This field represents the local port number for the connection. For client sockets, 
this field can either be specified by the application or automatically generated by the 

i 

network stack. For server sockets, this field is always specified by the application. 
IP Index (Address 0x02 [31 :28], 4 bits) 

This field represents the index in the network stacks IP address table for the IP 
address of the host interface for the socket, and is filled in by the network stack 
hardware. 

ConnState (Address 0x02 [27:24], 4 bits) 

This field indicates the current state of the connection, and decodes as follows: 
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Table 9 Socket State Decode Table 



State 


Description 


0x0 


Closed 


0x1 


Listen 


0x2 


SYN Received 


0x3 


SYN Sent 


0x4 


Established (Server) 


0x5 


Close Wait 


0x6 


Last ACK 


0x7 


FIN Wait 1 


0x8 


FIN Wait 2 


0x9 


Closing 


OxA 


Time Wait (Open CB) 


OxB 


Time Wait (TW CB) 



5 AX (Address 0x02 [23], 1 bit) 

This bit indicates that the Received ACK Status Message mode is enabled. In this 
mode, when an ACK is received that acknowledges all outstanding data, a status 
message is generated. This mode is used in conjunction with the Nagle Algorithm. 

10 

SA (Address 0x02 [22], 1 bit) 
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This bit indicates that the Selective ACK option (SACK) should be used with this 
socket (0 = Do not use SACK, 1 = Use SACK). 



TS (Address 0x02 [21], 1 bit) 

This bit indicates that the Timestamp option should be used with this socket (0 = Do 
not use timestamp option, 1 = Use timestamp option). 

WS (Address 0x02 [20], 1 bit) 

This flag indicates that the Sliding Window option has been successfully negotiated 
for the TCP socket (0 = Do not use WS option, 1 = WS option enabled). This bit is 
not used for UDP sockets. 

ZW (Address 0x02 [19], 1 bit) 

This bit indicates that the socket's peer window is 0x0000, and that the socket is in 
the zero-window probe state. 

AR (Address 0x02 [18], 1 bit) 

This bit is set when an ACK packet is to be transmitted on a particular socket. It is 
cleared when the ACK packet has been transmitted. 

CF (Address 0x02 [17], 1 bit) 
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This bit indicates that the current CB is in the RX to TX FIFO Buffer queue so it 
cannot be depreciated yet. Once the ACK for the socket is transmitted, the TCP 
transmit block moves the Open CB to a Time_Wait CB. 

5 CV (Address 0x02 [1 6], 1 bit) 

This bit indicates that the CB contains valid information. Prior to deprecating any 
CB, this bit is always cleared. 

1 0 RD (Address 0x02 [1 5], 1 bit) 

This bit indicates that the CB retransmission time expired, but it was unable to be 
queued for retransmission due to the priority queue being full. When the CB poller 
comes across this bit being asserted in a CB, then it disregards the retransmission 
15 time field and processes the CB for retransmission. This bit is cleared when the CB 
has been put into the priority sending queue. 

CBVer (Address 0x02 [14:12], 3 bits) 

20 These bit indicate the version of CB, and is mainly used by the on-chip processor so 
that it can differentiate types of CBs in future hardware versions. This field is 
currently defined as 0x1 . 

CB Interface (Address 0x02 [1 1:8], 4 bits) 

25 
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These bit are used to specify a particular physical interface for the socket and is 
used in multiport architectures. For single-port architectures, this field should be left 
at 0x0. 

5 SY (Address 0x02 [7], 1 bit) 

These bit indicates that the socket received a SYN packet while in the TW state. If 
this bit is set and we then receive a RST on the socket and the kill_tw_mode is set to 
0x00, then the CB is deprecated immediately. 

10 

ST (Address 0x02 [6], 1 bit) 

This bit indicates that the TX Left and Right SACK fields are valid. When the TCP 
receive logic notices a hole in the received data, the TCP receive logic puts the hole 
15 starting and ending addresses into the TX Left and Right SACK fields and sets this 
bit to indicate that the next transmitted packet should include the SACK option. 
When a packet is transmitted that included these parameters, this bit is cleared. 

SR (Address 0x02 [5], 1 bit) 

20 

This bit indicates that the RX Left and Right SACK fields are valid. When the TCP 
receive logic receives a SACK option, the TCP receive logic puts the first pair of 
SACK values into the RX Left and Right SACK fields, and sets this bit to indicate to 
the TCP transmitter that this section needs to be retransmitted. When the section is 
25 retransmitted, this bit is cleared. 
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KA (Address 0x02 [4], 1 bit) 

For TCP sockets, this bit indicates that the keep alive timer should be used with this 
socket (0 = don't use the keep alive timer, 1 = use the keep alive timer). For UDP 
5 sockets, this bit indicates whether the checksum should be checked or not (1 = 
enable checksums, 0 = ignore checksums). 

DF (Address 0x02 [3], 1 bit) 

10 This bit represents the state of the DF bit in the IP header for the socket. When this 
bit is set, the packet is not fragmented by any hop. This bit is used for path MTU 
discovery. 

VL (Address 0x02 [2], 1 bit) 

15 

This bit indicates whether VLAN tags are included in the outgoing Ethernet frames or 
not. If this bit is asserted, then 4 bytes of VLAN tag information made up by 
cb_tx_vlan_priority and cb_tx_vid, and the VLAN tag identification (fixed value) are 
included following the Ethernet Address fields. 

20 

RE (Address 0x02 [1], 1 bit, TCP CB's) 

This flag is used to indicate a timeout condition, and that a retransmission is 
required. It is cleared when the data is retransmitted. This bit is only defined for 
25 TCP CBs. 
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UP (Address 0x02 [1], 1 bit, UDP CB's) 

This flag is used to indicate whether the UDP port was dynamically allocated or pre- 
specified. If it is dynamically allocated, then it is de-allocated when the CB is 
5 deprecated. Otherwise if it is pre-specified, then no port action is done when the CB 
is deprecated. This bit is only defined for UDP CBs. 

AD (Address 0x02 [0], 1 bit) 

10 This bit indicates that an ACK is queued for delayed ACK transmission on the 
socket. This bit is set in the TCP RX logic, and cleared when the ACK is queued by 
the CB Poller for transmission. 

TX ACK Number (Address 0x03, 32 bits) 

15 

This is the running ACK number for TCP connections. It represents the expected 
SEQ number in received TCP PSH packets. When a TCP data packet is received, 
then SYN number is checked against this number. If it matches or if the SEQ 
number received + the length of the packet covers this number, then the data is 
20 accepted. This number is updated automatically by the network stack, and is not 
used for UDP connections. 

SEQ Number (Address 0x4, 32 bits) 
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This is the running SEQ number for TCP connections. It represents the SEQ 
number to be used in TCP packets, and is updated by the network stack 
automatically. This field is not used for UDP sockets. 

5 Keep Alive Time0x05 [31 :24], 8 bits) 

This field represents the time in the future when the keep alive trigger is asserted. 
This time is reset every time a packet is sent on the socket or a pure ACK packet is 
received. The time is represented here in units of minutes. 

10 

LWinScale (Address 0x05 [23:20], 4 bits) 

This field represents the local sliding window scale factor that is used for the 
connection. Valid values are from 0x00 to OxOE. 

15 

RWinScale (Address 0x05 [1 9: 1 6], 4 bits) 

This field represents the sliding window scale factor as requested by the remote end 
in the TCP SYN packet. Valid values are from 0x00 to OxOE. 

20 

Remote MSS (Address 0x05 [15:0], 16 bits) 

This field represents the MSS that received in the SYN packet for TCP connections. 
It indicates the largest packet size that the remote end can accept. If no MSS option 
25 was received, then this field defaults to 536 (0x0218). This field is not used for UDP 
connections. 
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PA (Address 0x06 [31], 1 bit) 

This bit is used to indicate that the port for the CB was auto allocated. If this bit is 
5 set, then when the time comes to deprecate the CB, this bit is examined to 
determine if the port needs to be de-allocated. 

Priority (Address 0x06 [30:28], 3 bits) 

10 This field represents the user priority level used for the VLAN tag. This field also 
represents the service level for the socket during transmission scheduling. The 
higher the number, the higher the priority (7 is the highest, and 0 is the lowest). The 
default value for this field is 0x0, and it is settable by software. 

15 VID (Address 0x06 [27:1 6], 1 2 bits) 

This field represents the VLAN Identification used in VLAN tag frames. The default 
value for this field is 0x000, and is settable by software. For connections initiated 
from a peer, this field is set by the VID received in the opening SYN packet. 

20 

Remote MAC Address (Addresses 0x06 [15:0] - 0x07, 48 bits total) 

These fields represent the destination MAC address for packets being transmitted on 
this socket. When the socket is first established, the ARP cache are queried for this 
25 address. After it is resolved, the address is stored here so that further ARP cache 
queries are avoided. If the CB is created as a server socket, then this address is 
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taken from the destination MAC address contained in the SYN packet. Bits [47:32] 
of the address are stored in CB address 0x6. 



Local IP Address (Address 0x08, 32 bits) 

5 

This field represents the local IP address for the socket connection. For client 
sockets, this field is specified by the application. For server sockets, this field is filled 
in when the CB is transitioned from Half Open to Open. 



1 0 RX ACK Number (Address 0x09, 32 bits) 



This field represents the latest ACK number received from the peer for this socket. It 
is used to determine if any retries are needed on a socket. Note that this may be a 
different number then the sequence number that is used in transmitted packets. 

15 

Congestion Window (cwnd) (Address OxOA [31:0], 32 bits) 

This field keeps track of the cwnd parameter. The cwnd parameter is used for the 
congestion avoidance and slow start algorithms, and is initialized to one MSS. 

20 

HA (Host ACK) (Address OxOB [31], 1 bit) 



This bit indicates that the Host_ACK mode is active for this socket. In this mode, 
data ACKs are triggered by the host, and are not sent automatically when the data is 
25 received. 
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This bit indicates that an RX DAV status message for the CB has been sent to the 
on-chip processor. The bit clears when the data are DMA'ed to the host. 

5 

Sock Type (Address OxOB [29:27], 3 bits) 

This field indicates the type of socket represented by the control block according to 
the following table. 

10 

Table 1 0 Socket Type Decode Table 



Sock 


Description 


Type 




000 


Reserved 


001 


UDP (Normal) 


010 


TCP Client 


101 


UDP (Raw) 


110 


TCP Server 



All other decodes not show are reserved for future use. In UDP Raw mode, the 
application is presented with the remote IP address and the UDP header information 
1 5 along with the UDP data. In UDP Normal Mode, only the data portion is presented to 
the application. 

Ml (Address OxOB [26], 1 bit) 
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This bit is used to indicate that no data are currently in the sockets receive memory 
block. 



RX Ending Mem Block Pointer (Address OxOB [25:0], 26 bits) 

This field represents the address of the last MRX buffer that received data was 
written into. It is used to link the next memory block that is used for the socket. 

RX Start Mem Block Pointer (Address OxOC [25:0], 26 bits) 

This field represents the address of the next MRX buffer to be sent to the host. 

HD (Address OxOC [26], 1 bit) 

This bit indicates that there is data left to be DMA'ed to the host and that the RX 
DMA status message has not been sent yet. The TCP RX logic sets this bit when it 
schedules an RX DMA operation, and is cleared by the TCP RX logic when it 
requests an RX DMA done status message. This bit is used to facilitate the FIN vs. 
Status message timing issue. 

IPSEC Mode (Address OxOC [30:27], 4 bits) 

These bits indicate the IPSEC modes enabled for transmitted packets on this socket 
connection. The decodes are shown in the following table. 
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Table 11 IPSEC Modes 



IPSEC Mode 


Description 


Bit 




0 


Tunnel AH 


1 


Tunnel ESP 


2 


Transport AH 


3 


Transport ESP 



If none of the bits are set, then no IPSEC is used on the socket. 

5 AB (ACK Req Pending) (Address OxOC [31], 1 bit) 

This bit indicates that an ACK request from the TCP receive logic to the TCP 
transmit logic is pending. It is set when a TCP data packet is received, and is 
cleared when the ACK for the data is sent. If another data packet is received while 
10 this bit is still set, then another ACK is not requested but the Received ACK number 
is updated. 

HR (Host Retransmit Socket) (Address OxOD [30], 1 bit) 
1 5 This bit indicates that this socket is an iSCSI application. 
AS (Address OxOD [30], 1 bit) 

This bit indicates that this socket is an on-chip processor socket application. 

20 
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DA (Address OxOD [29],' 1 bit) 

This bit indicates that we have done a retransmission due to duplicate ACKs. It is 
set when the retransmitted packet is sent. It clears when we get an ACK that 
5 advances the received ACK pointer. When we do get an ACK for new data after a 
duplicate ACK retransmission, we set cwnd = ssthresh (part of the fast recovery 
algorithm). This bit is used in conjunction with the DS bit in word 0x14. We need two 
bits because the retransmission of the missing segment is only done once. 

1 0 R0 (Address OxOD [28], 1 bit) 

This bit indicates that the Retransmission Time field is valid (0= invalid, 1 = valid). 

RV (Address OxOD [27], 1 bit) 

15 

This bit indicates that the Retransmission Time field is valid (0= invalid, 1 = valid). 
TP (Address OxOD [26], 1 bit) 

20 This bit indicates that a packet being timed is currently in transit. It is only used if the 
RTO option is not enabled. 

Next TX Mem Block Pointer (Address OxOD [25:0], 26 bits) 
25 This field represents the address of the next MTX buffer to be transmitted. 
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These bits are used to specify the MSS size to be used in the SYN packet. Available 
settings are as follows: 



Table 1 2 MSS Size Settings 



MSS 
Size 


Selection 


00 


Default MSS (based on local / 
nonlocal setting ) 


01 


2048 


10 


MSS Setting 1 (registers 0x1 ACO - 
0x1 AC1) 


11 


MSS Setting 2 (registers 0x1 AC2 - 
0x1 AC3) 



Silly Window Size (Address OxOE [29:0], 30 bits) 

This field represents the running window size as kept tracked by the TCP RX 
hardware. This window keeps the actual window size, and it is only transferred to 
the real window when it is more then an MSS greater. 

RX DMA Count (Address OxOF [31:16], Address 0x12 [31:24] 24 bits) 

This field represents number of bytes transmitted via RX DMA to the host since the 
last RX DMA status message. The MSB of the count is stored in Address 0x12. 
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Host Buffer Offset Pointer (Address OxOF [1 5:0], 1 6 bits) 

This field represents the offset into the current Host memory buffer that the RX DMA 
5 is using. 

Window Clamp (Address 0x10 [31:0], 32 bits) 

This field represents the maximum advertised window allowed for the socket 
10 connection. 

RX Link List Address (Address 0x1 1 [31:0], 32 bits) 

This is the on-chip processor memory address of the RX Link list used for RX DMA 
15 operations. 

RX Transfer Limit (Address 0x12 [15:0], 16 bits) 

This is the transfer limit for RX DMA transfers. A RX DMA status message is 
20 generated when this limit is reached. For CBs that require a status message after 
each DMA transfer, this limit should be set to 0x0001 . 

RX Link List Entries (Address 0x12 [23:16], 8 bits) 

25 This is the number of entries in the RX DMA Link List. 
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K (keep alive triggered) (Address 0x13 [31], 1 bit) 

This bit is used to indicate that the current CB is in the keepalive state. The bit is set 
when the keepalive timer expires for the CB, and is either cleared when the CB is 
5 de-allocated, due to the keepalive finding that the other side has gone away (died), 
or by TCP-RX when it receives a response to the keepalive probe (an ACK packet). 

DupAck (Address 0x13 [30:28], 3 bits) 

10 This field keeps track of how many duplicate ACKs were received. This parameter is 
used for the fast retransmission algorithm. 

Retries / Probes (Address 0x13, [27:24], 4 bits) 

15 This field keeps track of how many retries were sent out for a particular packet. It is 
also used to keep track of the number of number of Window probes sent. The latter 
number is needed so that the proper window probe transmission interval can be 
used. 

20 TX Data Avail (Address 0x1 3 [23:0], 24 bits) 

This field represents the total amount of data available to be transmitted on the 
socket. 

25 Socket Channel Number (Address 0x1 4 [31 :24], 8 bits) 
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This is the socket channel number. When status messages are sent back to the 
host, this channel specifies which queue to be used. 



SX (Address 0x14 [23], 1 bit) 

5 

This bit indicates that a SACK retransmit is needed. It is set by the retrans module 
and cleared when the SACK retrans is sent out. 

FX (Address 0x14 [20], 1 bit) 

10 

This bit indicates that a FIN packet has been sent out on this socket. It is set by the 
TCP TX logic. 

DA (Address 0x14 [19], 1 bit) 

15 

This bit indicates that the socket is in a duplicate ACK state. This bit is set when the 
duplicate ACK threshold is reached. It is cleared when the peer ACKs new data. 

UM (Address 0x14 [18], 1 bit) 

20 

This bit indicates that the Peer's advertised window has exceeded twice the MSS. If 
this bit is set then data is stored in MTX at a maximum of the MSS size. If the bit is 
not set, then data is stored at a maximum of one-quarter the MSS. 

25 UC (Address 0x14 [17], 1 bit) 
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This bit indicates that the type of control block in the Next CB Link field is a U DP CB. 



TW (Address 0x14 [16], 1 bit) 
5 This bit indicates that the type of control block in the Next CB Link field is a TW CB. 
Next CB Link (Address 0x14 [15:0], 16 bits) 

This field represents the CB memory address of the next linked CB. This CB would 
10 have the same Hash value as this socket. The VSOCK submodule fills this field in 
when it links CBs with the same Hash value. 

RX Window Size (Address 0x15 [31 :16], 16 bits) 

15 This field represents the advertised window of the remote end unadjusted by the 
sliding window scale factor. 

IP TTL (Address 0x15 [15:8], 8 bits) 

20 This field represents the TTL to be used in the IP header for the socket. 

IP TOS (Address 0x1 5 [7:0], 8 bits) 

This field represents the TOS field setting used in the IP header for the socket 
25 connection. It is an optional parameter that may be set by the application. If no TOS 
parameter is specified, then this field defaults to 0x00. 
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RX Timestamp / Timed Seq Number (Address 0x1 6, 32 bits) 



When timing one segment at a time, then this field is used to store the sequence 
5 number of the packet being timed. When an ACK is received that covers this 
sequence number, then the RTT can be derived for the packet. The timestamp for 
when this packet was transmitted is stored in the Local Timestamp of Last 
Transmission field. When the timestamp option is enabled, this field is used to store 
the timestamp received in TCP packets. 

10 

Smooth Mean Dev. (Address 0x17, 32 bits) 



This field represents the smoothed mean deviation in round trip time measurements 
as calculated using the Van Jacobson algorithm specified in RFC 793. 

15 

Slow Start Threshold (ssthresh) (Address 0x18, 32 bits) 



This field keeps track of the ssthresh parameter. The ssthresh parameter is used 
for the congestion avoidance algorithms, and is initialized to OxOOOOFFFF. 

20 

Smooth RTT (Address 0x19, 32 bits) 



This field represents the smoothed round trip time value as calculated using the Van 
Jacobson algorithm specified in RFC 793. 

25 

Retransmission Timestamp (Address 0x1 B, 16 bits) 
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This field is used to represent the time in the future of when a retransmission is 
necessary on the socket. 



5 TX Left SACK (Address 0x1 C, 32 bits) 



This field represents the sequence number of the first (lowest sequence number) 
byte of the first island of out-of-sequence received data after the in-sequence data. 



1 0 TX Right SACK (Address 0x1 D, 32 bits) 

This field represents one the plus the sequence number of the last (highest 
sequence number) byte of the first island of out-of-sequence received data after the 
in-sequence data. 

15 

RX Left SACK (Address 0x1 E, 32 bits) 



This field represents the sequence number of the first byte of the first island of out- 
of-sequence data reported by the SACK option of a received packet. 

20 

RX Right SACK (Address 0x1 F, 32 bits) 



This field represents one plus the sequence number of the last byte of the first island 
of out-of-sequence data reported by the SACK option of a received packet. 

25 

Established Socket Annex CB Structure 
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The following table lists all fields in the annex CB structure in memory for established 
sockets. 



Table 13 Established Socket Annex CB Structure 



o 
1 

2 
3 
4 
5 
6 
7 
8 
9 
A 
B 
C 
D 
E 
F 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
1A 
1B 
1C 
1D 
1E 
1F 



SACK Block Count [7:0] 



TX Left SACK Mem Add (23:0] 



SACK Block Count [15:8] 



TX Right SACK Mem Add [23:0] 



RX Bytes Received [53:0] 



TX Bytes Received [63:0] 



« HHnu H Y//////////////77X 



MDl Transfer Length [15:0] 



IPSEC Hash [31:0] 



LastUnACrCed Seq [31:0] 



ISCS1 RM Interval [15:0] 



{SCSI RM Offset [15:0] 



ISCSICRC Seed [31:0] 

///////////X re I 'PSEC Overhead [7:0] 



MRX Buffers [15:0] 



RM 


RP 


FP 


LD 


DP 


SV 



DAV Buffer Length [15:0] 



TX Tunnel ESP Handle [15:0] 



TX Tunnel AH Handle [15:0] 



TX Transport ESP Handle [15:0] 



TX Transport AH Handle 115:0] 



'//f SBV81 iSCSI Byte 2 [7:0] 



iSCSI Byte 1 [7:0] 



iSCSI Byte 0 [7:0] 



Local MSS [15:0] 



Max RX Window [15:0] 



Last cwnd Update [31:0] 




Established Socket Annex CB Field Definitions 



1 0 RX Left SACK Mem Add (Address 0x0 [23:0], 24 bits) 
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This field represents the first address of the first MRX memory block of the linked list 
of blocks for the SACK island. 



RX Right SACK Mem Add (Address 0x1 [23:0], 24 bits) 

5 

This field represents the first address of the last MRX memory block of the linked list 
of blocks for the SACK island. 

SACK Block Count (Addresses 0x0-0x1 [31:24], 16 bits) 

10 

This field represents the number of memory blocks used by the socket. 
RX Bytes Written (Address 0x2 - 0x3, 64 bits) 

1 5 This field represents the total number of bytes written to MRX memory for the socket. 
The least significant word is stored in address 0x2 and the most significant word is 
stored in address 0x3. 

TX Bytes Transmitted (Address 0x4 - 0x5, 64 bits) 

20 

This field represents the total number of bytes transmitted on the socket. The least 
significant word is stored in address 0x4 and the most significant word is stored in 
address 0x5. 

25 iS (Address 0x6 [31], 1 bit) 
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This bit indicates that CB is being used as an iSCSI socket. 
MD (Address 0x6 [30], 1 bit) 

This bit indicates that CB is using MDLs for the received buffer list. 
DS (Address 0x6 [29], 1 bit) 

This bit indicates that we have received a Duplicate ACK on the socket. It is set by 
the logic that processes the duplicate ACKs. If a duplicate ACK is received, and this 
bit is already set, then the missing segment is not retransmitted. It is used in 
conjunction with the DA bit in word OxOD of the main Open CB structure. The state 
table for these two bits are as follows: 



Table 14 DS / DA Bit State Table 



DS 


DA 


State 


0 


0 


No Duplicate ACKs received on the socket yet. 


1 


0 


Duplicate ACK received but missing segment not sent 
yet 


1 


1 


Duplicate ACK received and missing segment 
retransmitted 


1 


0 


Illegal condition 



iSCSI Seed Not Updated (IN) (Address 0x6 [28], 1 bit) 
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This bit is set by the davscan module when an iSCSI memory block is being 
processed and is cleared when the seed for that block has been saved. The bit is 
asserted by the hardware to indicate to the host that its local copy of the CRC seed 
is not updated. When the host wants to reset the CRC seed, it needs to first probe 
5 this bit. If the bit is asserted, then it needs to set the Seed_Clrd_by_Host bit in the 
socket. The hardware clears this bit when it has updated its local copy of the CRC 
seed with the new value written by the host. 

iSCSI Seed Cleared By Host (CH) (Address 0x6 [27], 1 bit) 

10 

This bit is set by the host when it writes a new value to the iSCSI seed in the CB 
AND the IN bit is set. When the davscan module sees that this bit is set, it clears the 
iSCSI seed and this bit in the CB. 

1 5 MDL Transfer Length (Address 0x6 [1 5:0], 1 6 bits) 

This field is used to indicate how long the MDL DMA transfer should be. It is usually 
the same length as reported in the RX_DAV status message that generated the 
RX_MDL IB. 

20 

IPSEC Hash (Address 0x7 [31:0], 31 bits) 

This field represents the hash value for all the SA entries used for the socket 
connection. 

25 

Last UnACK'ed Sequence Number (Address 0x8, 32 bits) 
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This field represents the last unACK'ed sequence number from the peer. This value 
is used for Timestamp storing calculations. 

5 iSCSI FIM Interval (Address 0x9 [31 :16], 16 bits) 

This field represents the FIM interval for the iSCSI connection. It is stored as the 
number of bytes. 

1 0 iSCSI FIM Offset (Address 0x9 [1 5:0], 1 6 bits) 

This field represents the number of bytes until the next FIM insertion. 

iSCSI CRC Seed (Address OxA, 32 bits) 

15 

This field represents the CRC seed for received iSCSI data. 

IPSEC Overhead (Address OxB [7:0], 8 bits) 

20 This field represents the overhead in terns of number of double words (four bytes) 
that the IPSEC headers (and extra IP header) takes up in a packet. This information 
is used when determining how much data can be put into a packet. 

iSCSI FIM Enable [FE] (Address OxB [8], 1 bit) 

25 
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This bit indicates whether FIM support is needed on the CB (0 = FM disabled, 1 = 
FIM enabled). 

MRX Buffers (Address OxB [31:16], 16 bits) 

5 

This field represents the number of MRX buffers currently being used by the socket. 
When this number reaches the MRX buffer limit (global setting), then no more data 
packets are accepted on the socket. 

1 0 DAV Buffer Length (Address OxC [1 5:0], 1 6 bits) 

This field indicates the length of the buffer to be used for the DAV status message. 

RX Send FIN Status Message [SM] (Address OxC [16], 1 bit) 

15 

This bit indicates that an RX FIN Received status message should be sent for the 
CB. 

RX Send DAV Status Message [SV] (Address OxC [17], 1 bit) 

20 

This bit indicates that an RX DAV status message should be sent for the CB. 
RX DMA Status Message Pending [DP] (Address OxC [18], 1 bit) 
25 This bit indicates that an RX DMA done status message is pending on the CB. 
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This bit indicates that the last DMA for a host buffer segment is being sent. Upon 
completion of this DMA, an RX DMA status message is generated. 

5 

FIN Status Message Pending [FP] (Address OxC [20], 1 bit) 

This bit indicates that a FIN status message is pending. It is set when there are data 
left in MRX memory but no DMA is currently in progress. It is cleared when the DMA 
1 0 starts and the SV bit sets. 

Reset Pending [RP] (Address OxC [21], 1 bit) 

This bit indicates that a reset status message is pending, and it should be sent after 
15 the RX DMA status message. It is set when there are data left in MRX memory but 
no DMA is currently in progress. It is cleared when the DMA starts and the SV bit 
sets. 

Send Reset Message [RM] (Address OxC [22], 1 bit) 

20 

This bit indicates that a RST packet was received and is only used between the 
tcprxsta and davscan modules. 

Open to TW [OT] (Address OxC [23], 1 bit) 

25 
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This bit indicates that the socket has transitioned to the timewait state and that the 
open to timewait transfer process is complete. This bit is set by davscan and read 
by rxcbupd.v 

5 Zero Window Timestamp (Address OxC [31 :24], 1 6 bits) 

This field indicates the timestamp in the future of when to send the next zero window 
probe. 

1 0 TX Tunnel AH Handle (Address OxD [1 5:0], 1 6 bits) 

This field represents the TX Tunnel AH SA (Security Association) handle associated 
with the socket. 

1 5 TX Tunnel ESP Handle (Address OxD [31 :1 6], 1 6 bits) 

This field represents the TX Tunnel ESP SA (Security Association) handle 
associated with the socket. 

20 TX Transport AH Handle (Address OxE [1 5:0], 1 6 bits) 

This field represents the TX Transport AH SA (Security Association) handle 
associated with the socket. 

25 TX Transport ESP Handle (Address OxE [31 : 1 6], 1 6 bits) 
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This field represents the TX Transport ESP SA (Security Association) handle 
associated with the socket. 



iSCSI Bytes 0-1-2 (Address OxF [23:0], 8 bits each) 

5 

These bytes represent the non-aligned bytes for iSCSI CRC calculations. 
SBVal (Address OxF [25:24], 2 bits) 
10 This field is used to indicate which of the iSCSI Bytes[2:0] are valid. 
Max RX Window (Address 0x1 0 [1 5:0], 1 6 bits) 

This field represents the maximum window advertised by the peer. It is used to 
1 5 determine what parameter to use for the MTX data packing limit. 

Local MSS (Address 0x10 [31:16], 16 bits) 

This field represents the local MSS value used in the SYN or SYN/ACK packet. It is 
20 used for window size adjustments. 

Last CWND Update (Address 0x1 1 [31:16], 16 bits) 

This field represents the last timestamp that the cwnd was updated this information 
25 is used to increment the cwnd when it is greater then the ssthresh. 
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This field represents the DMA ID for the CB. This field is incmreneted everytime a 
TCP TX DMA is requested. When the xmtcbwr module finishes packing a DMA 
5 transfer, and if the DMA ID matches what is in the CB, then the DMA_Pending bit is 
cleared (by xmtcbwr). 

DMA Pending (Address 0x1 2 [4], 1 bit) 

10 This field indicates that TX DMA is pending on this socket. This bit is set by 
sockregs when it requests a TX DMA, and is cleared by xmtcbwr. v. when the TX 
DMA ID just processed matches the TX_DMA ID in the CB. 

Combined CB Structure 

15 

In CB memory, the socket CB's are stored as one contiguous memory block. The 
format is shown in the following table. 
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Table 1 5 Combined CB Structure 
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Half Open Socket Main CB Structure 
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The following table defines the main CB structure in memory for half-open sockets. 



i 
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Table 16 Half Open Socket Main CB Structure 



15 



12 



8 



15:0 



remote IP address [15:0] 



31:16 



remoto IP address {31:16} 



47:32 



remote port [15:0) 



63:48 



toco) port 1*5:0} 



15:0 



local IP Index p:C] 



Connection State (3:0} 



RxACK SACK 



RxTS 



WnSc RxMSS ACKRq CBInFF CBVet 



31:16 



CB Version (3:0) 



TXtnterfacePfl] 



IPSEC 



OF 



VUNV Rctran FfeURO 



47:32 



ACK (15:0] 



63:48 



ACKP1:1B) 



15:0 



SEQ [15.-0} 



31:16 



SEQ [31:16} 



47:32 



SA Overhead [7:0} 



Local WlnScaJe|3:0] 



Remoto WinScalo [3:0] 



63:48 



VLAN Prtonly [HoT 



MSS 115:0) 



15:0 



VLAN WD {11 «] 



31:16 



remote MAC Address [15.DJ 



47:32 



remote MAC Address [31:16] 



63:48 



remote MAC Address [47:32] 



15:0 



Received Times! amp [15:0] 



31:16 



Received Tlmestamp [31:16] 



47:32 



Local Tlmestamp (15:0] 



63:48 



Local Tlmestamp [31:16] 



15:0 



31:16 



tPSEC Mode [3 0] V//////////////////////A Number of SYN/ACK retries [3:0] 



47:32 



Local IP Address (1 5:0) 



63:48 



Local IP Address [31:16] 



15:0 



TX Tunnel AH SA[15;0J 



31:16 



TX Tunnel ESP SA [15.-0] 



47:32 



SA Hash [15:0] 



63:48 



SAHosh [25:16] 



15:0 



TX Transport AH SA [15:0] 



31:16 



TX Transport ESP SA [15:0] 



47:32 



Local MSS 115:0} 



63:48 
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Half Open Socket Main CB Field Definitions 



Remote IP Address (32 bits, Word 0x0 [31 :0]) 

This is the IP address of the remote end of the connection. Bits [31:16] of the IP 
address are stored in Word 0x0 and bit [15:0] are stored in Word 0x1 . 

Remote Port (16 bits, Word 0x0 [47:32]) 
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This is the port address of the remote end of the connection 



Local Port (16 bits, Word 0x0 [63:48]) 
5 This is the port address of the local end of the connection 
Local IP Index (4 bits, Word 0x1 [15:12]) 

This is the index of the local IP address to be used for this connection. This value is 
10 resolved by the IP module into a full IP address and a corresponding MAC address. 

Connection State (4 bits, Word 0x1 [1 1 :8]) 

This is the current state of the connection and decodes as follows: 

15 

Table 17 Connection State Decode 



State 


Description 


0x0 


Closed 


0x1 


Listen 


0x2 


SYN Received 


0x3 


SYN Sent 


0x4 


Established 


0x5 


Close Wait 


0x6 


Last ACK 


0x7 


FIN Wait 1 


0x8 


FIN Wait 2 
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0x9 


Closing 


OxA 


Time Wait (Open CB) 


OxB 


Time Wait (TW CB) 



RxACK (1 bit, Word 0x1 [7]) 

This bit indicates that the RX ACK Status Message mode is enabled. In this mode, 
5 when an ACK is received that acknowledges all outstanding data, a status message 
is generated. 

SACK (1 bit, Word 0x1 [6]) 
10 This bit indicates that the remote end sent the SACK option in its SYN packet 
RxTS (1 bit, Word 0x1 [5]) 

This bit indicates that the remote end sent the timestamp option and the Received 
15 Timestamp field is valid in the Half Open Annex control block. 

WinSc (1 bit, Word 0x1 [4]) 

This bit indicates that the remote end sent the Window Scale option 

20 

RxMSS (1 bit, Word 0x1 [3]) 
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This bit indicates that the remote end sent an MSS option, and that the remote MSS 
field is valid 

ACKRq (1 bit, Word 0x1 [2]) 

5 

This bit indicates that an ACK is requested for this socket. It is meant to duplicate 
the similar bit in the Establish Control blocks, but is not used here. 

CBinFF (1 bit, Word 0x1 [1]) 

10 

This bit indicates that this CB is in the Rx to TX FF queue and therefore cannot be 
killed yet. 

CBVal (1 bit, Word 0x1 [0]) 

15 

This bit indicates that the Half Open CB is valid. 
CB Version (4 bits, Word 0x1 [31:28]) 
20 These bits indicate the version of the CB. This field is currently defined to be 0x1 . 
TX Interface (4 bits, Word 0x1 [27:24]) 

These bits indicate which interface the originating SYN came in on. 

25 

IPSEC(1 bit, Word 0x1 [23]) 
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This bit indicate that the HO CB is being used for an IPSEC protected socket. In this 
case, a SYN received that does not match this HO CB is discarded. 

5 MSS Size (2 bits, Word 0x1 [22:21]) 

These bits are used to specify the MSS size to be used in the SYN/ACK packet. 
Available settings are as follows: 

10 Table 18 MSS Size Settings 



MSS 
Size 


Selection 


00 


Default MSS (based on local / 
nonlocal setting ) 


01 


2048 


10 


MSS Setting 1 (registers 0x1 AC0 - 
0x1 AC1) 


11 


MSS Setting 2 (registers 0x1 AC2 - 
0x1 AC3) 



KA (1 bit, Word 0x1 [20]) 

This bit indicates that the keepalive timer should be used on this socket 

15 

DF(1 bit, Word 0x1 [19]) 
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This bit is used to specify the Don't Fragment bit in the IP header. 
VLANV (1 bit, Word 0x1 [18]) 
5 This bit indicates that the VLAN fields are valid. 
Retrans (1 bit, Word 0x1 [17]) 

This bit indicates that a retransmission is needed on this socket. 

10 

RxURG (1 bit, Word 0x1 [16]) 

This bit indicates that the URG bit was set on a received packet. 
1 5 ACK (32 bits, Word 0x1 [63:32]) 

This is the ACK number to be used in a transmitted packet. 
SEQ (32 bits, Word 0x2 [31 :0]) 

20 

This is the running sequence number used in transmitted packets. 

SA Overhead (8 bits, Word 0x2 [47:40]) 

25 This field is used to store the IPSEC Overhead (in number of double words) for the 
CB. 
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Local WinScale (4 bits, Word 0x2 [39:36]) 

This field represents the local sliding window scale factor that is used for the 
5 connection. Valid values are from 0x00 to OxOE. 

Remote WinScale (4 bits, Word 0x2 [35:32]) 

This field represents the sliding window scale factor as requested by the remote end 
10 in the TCP SYN packet. Valid values are from 0x00 to OxOE. 

Remote MSS (16 bits, Word 0x2 [63:48]) 

This field represents the MSS that received in the SYN packet for TCP connections. 
15 It indicates the largest packet size that the remote end can accept. If no MSS option 
was received, then this field defaults to 536 (0x0218). This field is not used for UDP 
connections. 

VLAN Priority (3 bits, Word 0x3 [14:12]) 

20 

This field represents the user priority level used for the VLAN tag. It also represents 
the service level for the socket during transmission scheduling. The higher the 
number, the higher the priority (7 is the highest, and 0 is the lowest). The default 
value for this field is 0x0, and it may be set by software. 

25 

VLAN VID (12 bits, Word 0x3 [1 1:0]) 
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This field represents the VLAN Identification used in VLAN tag frames. The default 
value for this field is 0x000, and is settable by software. For connections initiated 
from a peer, this field is set by the VI D received in the opening SYN packet. 

Remote MAC Address (48 bits, Word 0x3 [63:16]) 

These fields represent the destination MAC address for packets being transmitted on 
this socket. When the socket is first established, the ARP cache is queried for this 
address. After it is resolved, the address is stored here so that further ARP cache 
queries are avoided. If the CB is created as a server socket, then this address is 
taken from the destination MAC address contained in the SYN packet. 

Received Timestamp (32 bits, Word 0x4 [31:0]) 

This is the timestamp included in a received packet. 

Local Timestamp (32 bits, Word 0x4 [63:32]) 

This is the timestamp of the last packet transmitted for this socket. 

TTL (8 bits, Word 0x5 [15:8]) 

This is the TTL to be used for the connection. When the SYN/ACK is being 
generated, this parameter is provided by the IP Router, and stored in this location. 
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When the socket transitions to the Established state, this information is passed to the 
open control block. 



TOS (8 bits, Word 0x5 [7:0]) 

5 

This is the TTL to be used for the connection. When the SYN/ACK is being 
generated, this parameter is provided by the IP Router, and stored in this location. 
When the socket transitions to the Established state, this information is passed to the 
open control block. 

10 

Number of SYN/ACK Retries (4 bits, Word 0x5 [19:16]) 

This field keeps track of the number of SYN/ACK retries sent for a particular socket. 
If the number of retries reaches the programmed maximum, then the socket is 
15 deprecated. 

IPSEC Mode (4 bits, Word 0x5 [31 :28]) 

This field is used to indicate which IPSEC modes are active for the socket. Decodes 
20 for this field are shown below. 



Table 19 IPSEC Mode Bit Definitions 



Bit 


Definition 


0 


Tunnel AH 


1 


Tunnel ESP 


2 


Transport AH 
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Transport ESP 



Local IP Address (32 bits, Words 0x5 [63:32]) 

This field is used to store the destination IP address received in the SYN packets. It 
5 represents the local IP address for the socket connection. 

TX Tunnel AH SA Handle (16 bits, Word 0x6 [15:0]) 

This field is used to store the TX Tunnel AH SA handle for the CB (if applicable). 

10 

TX Tunnel ESP SA Handle (16 bits, Word 0x6 [31:16]) 

This field is used to store the TX Tunnel ESP SA handle for the CB (if applicable). 
15 SA Hash (31 bits, Word 0x6 [63:32]) 

This field is used to store the SA Hash for the CB. 
TX Transport AH SA Handle (16 bits, Word 0x7 [15:0]) 

20 

This field is used to store the TX Transport AH SA handle for the CB (if applicable). 
TX Transport ESP SA Handle (16 bits, Word 0x7 [31:16]) 
25 This field is used to store the TX Transport ESP SA handle for the CB (if applicable). 
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Local MSS (16 bits, Word 0x7 [47:32]) 

This field is used to store the local MSS value used in the connection. It is needed 
for window size adjustments to avoid the Silly Window Syndrome. 

Time Wait CB Structure 

The following table defines the CB structure in memory for sockets in the Time_Wait 
state. 

Table 20 Time Wait CB Structure 
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7 


j Remote MAC Address p1 :0] 


8 


Local IP Address [31:0] 


9 


Remote Tlmeslamp [31:0] 


A 


TW Creation TImestamp [31:0] 


B 


Tunnel AH Handle [7:0] 


Forward Link [23:0] 


C 


Tunnel AH Handle [15:8J 


'///////////////////////////////////A 


D 


Tunnel ESP Handle [7:0] 


Forward Age Link [23:01 


E 


Tunnel ESP Handle [15:8] 


Reverse Age Link [23:0] 


F 






Transport ESP Handle [15:0] 


Transport AH Handle [15:0] 



Time Wait CB Field Definitions 



Remote IP Address (Address 0x00, 32 bits) 
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This 32-bit field represents the remote IP address for the connection. For client 
sockets, this field is set by the application. For server sockets, this field is filled in by 
the IP address received in the SYN packet or the IP address in the received UDP 
packet. 

5 

Remote Port (Address 0x01 [31:16], 16 bits) 

This field represents the remote port number for the connection. For client sockets, 
this field is always specified by the application. For server sockets, this field is 
10 always filled in with the port number received in the SYN or UDP packet. 

Local Port (Address 0x01 [15:0], 16 bits) 

This field represents the local port number for the connection. For client sockets, 
15 this field can either be specified by the application or automatically generated by the 
network stack. For server sockets, this field is always specified by the application. 

IP Index (Address 0x02 [31:28], 4 bits) 

20 This field represents the index in the network stacks IP address table for the IP 
address of the host interface for the socket, and is filled in by the network stack 
hardware. 

ConnState (Address 0x02 [27:24], 4 bits) 

25 

This field indicates the current state of the connection, and decodes as follows: 
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Table 21 Socket State Decode Table 



State 


Description 


0x0 


Closed 


0x1 


Listen 


0x2 


SYN Received 


0x3 


SYN Sent 


0x4 


Established 


0x5 


Close Wait 


0x6 


Last ACK 


0x7 


FIN Wait 1 


0x8 


FIN Wait 2 


0x9 


Closing 


OxA 


Time Wait (Open CB) 


OxB 


Time Wait (TW CB) 



RX (Address 0x02 [23], 1 bit) 

5 

This bit indicates that the RX ACK Status Message mode is enabled. This mode has 
no meaning for TW CB's. 

SA (Address 0x02 [22], 1 bit) 

10 

This bit indicates that the Selective ACK option (SACK) should be used with this 
socket (0 = Do not use SACK, 1 = Use SACK). 
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This bit indicates that the Timestamp option should be used with this socket (0 = Do 
not use timestamp option, 1 = Use timestamp option). 

5 

WS (Address 0x02 [20], 1 bit) 

This flag indicates that the Sliding Window option has been successfully negotiated 
for the TCP socket (0 = Do not use WS option, 1 = WS option enabled). This bit is 
1 0 not used for UDP sockets. 

MS (Address 0x02 [19], 1 bit) 

This bit indicates that the remote MSS field in the CB is valid. The MSS is located in 
15 Word 5 [15:0]. 

AR (Address 0x02 [18], 1 bit) 

This bit is set when an ACK packet is to be transmitted on a particular socket. It is 
20 cleared when the ACK packet has been transmitted. 

CF (Address 0x02 [17], 1 bit) 

This bit indicates that the current CB is in the RX to TX FIFO Buffer queue so it 
25 cannot be depreciated yet. Once the ACK for the socket is transmitted, the TCP 
transmit block moves the Open CB to a Time_Wait CB. 
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CVI (Address 0x02 [16], 1 bit) 

This bit indicates that the CB contains valid information. Prior to deprecating any 
5 CB, this bit is always cleared. 

CBVer (Address 0x02 [1 5:12], 4 bits) 

These bit indicate the version of CB, and is used by the on-chip processor to 
10 differentiate CBs in future versions of the hardware. This field is currently defined as 
0x1. 

CB Interface (Address 0x02 [1 1:8], 4 bits) 

15 These bit are used to specify a particular physical interface for the socket and is 
used in multiport architectures. For single-port architectures, this filed should be left 
at 0x0. 

KA (Address 0x02 [4], 1 bit) 

20 

This bit indicates that the keepalive timer should be used with this socket (0 = don't 
use the keepalive timer, 1 = use the keepalive timer). 

DF (Address 0x02 [3], 1 bit) 

25 
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This bit represents the state of the DF bit in the IP header for the socket. When set, 
the packet is not fragmented by any hop. This bit is used for path MTU discovery. 



VL (Address 0x02 [2], 1 bit) 

This bit indicates whether VLAN tags are included in the outgoing Ethernet frames or 
not. If it is asserted, then four bytes of VLAN tag information made up by 
cb_tx_vlan_priority and cb_tx_vid, and the VLAN tag Identification (fixed value) are 
included following the Ethernet Address fields. 

RE (Address 0x02 [1], 1 bit) 

This flag is used to indicate a timeout condition, and that a retransmission is 
required. It is cleared when the data are retransmitted. 

UR (Address 0x02 [0], 1 bit) 

This bit indicates that urgent data were received. It remains asserted until the 
application has read (or indicated that it has read) past the received urgent data 
pointer. 

ACK Number (Address 0x03, 32 bits) 

This is the running ACK number for TCP connections. It represents the expected 
SEQ number in received TCP PSH packets. When a TCP data packet is received, 
then SYN number is checked against this number. If it matches or if the SEQ 
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number received + the length of the packet covers this number, then the data is 
accepted. This number is updated automatically by the network stack, and is not 
used for UDP connections. 

5 SEQ Number (Address 0x4, 32 bits) 

This is the running SEQ number for TCP connections. It represents the SEQ 
number to be used in TCP packets, and is updated by the network stack 
automatically. This field is not used for UDP sockets. 

10 

IPSEC Mode (Address 0x5 [30:27], 4 bits) 

This field is used to indicate which IPSEC modes are active for the socket. Decodes 
for this field are shown below. 

15 

Table 22 IPSEC Mode Bit Definitions 



Bit 


Definition 


0 


Tunnel AH 


1 


Tunnel ESP 


2 


Transport AH 


3 


Transport ESP 



Sock Type (Address 0x05 [26:24], 3 bits) 



20 This field indicates the type of socket represented by the control block according to 
the following table. 
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Table 23 Socket Type Decode Table 



Sock 


Description 


Type 




000 


Reserved 


001 


UDP (Normal) 


010 


TCP Client 


101 


UDP (Raw) 


110 


TCP Server 



LWinScale (Address 0x05 [23:20], 4 bits) 

5 

This field represents the local sliding window scale factor that is used for the 
connection. Valid values are from 0x00 to OxOE. 

RWinScale (Address 0x05 [19:16], 4 bits) 

10 

This field represents the sliding window scale factor as requested by the remote end 
in the TCP SYN packet. Valid values are from 0x00 to OxOE. 

Local Window (Address 0x05 [15:0], 16 bits) 

15 

This field represents the 1 6 bits of Window that are advertised in the TCP local 
window field. 

Priority (Address 0x06 [30:28], 3 bits) 
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This field represents the user priority level used for the VLAN tag. It also represents 
the service level for the socket during transmission scheduling. The higher the 
number, the higher the priority (7 is the highest, and 0 is the lowest). The default 
5 value for this field is 0x0, and it may be set by software. 

VID (Address 0x06 [27:16], 12 bits) 

This field represents the VLAN Identification used in VLAN tag frames. The default 
10 value for this field is 0x000, and is settable by software. For connections initiated 
from a peer, this field is set by the VLAN identitication received in the opening SYN 
packet. 

Remote MAC Address (Addresses 0x06 [15:0] - 0x07, 48 bits total) 

15 

These fields represent the destination MAC address for packets being transmitted on 
this socket. When the socket is first established, the ARP cache is queried for this 
address. After it is resolved, the address is stored here so that further ARP cache 
queries are avoided. If the CB is created as a server socket, then this address is 
20 taken from the destination MAC address contained in the SYN packet. Bits [47:32] 
of the address are stored in CB address 0x6. 

Local IP Address (Address 0x8, 32 bits) 

25 This field represents the local IP address of the socket connection. 
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Remote Timestamp (Address 0x9, 32 bits) 

This is the timestamp included in a received packet. 

TW Creation Timestamp (Address OxA, 32 bits) 

This is the timestamp of when the CB entered the Time Wait state. 

Tunnel AH Handle (Address OxB [31 :24], Address OxC [31 :24], 16 bits) 

This is the Tunnel AH SA handle for the CB. It is valid when the Tunnel AH (TA) bit 
in the CB is also set. 

Forward Link (Address OxB [23:0], 24 bits) 
Link to the next CB in the search chain. 

Tunnel ESP Handle (Address OxD [31 :24], Address OxE [31 :24], 16 bits) 

This is the Tunnel ESP SA handle for the CB. It is valid when the Tunnel ESP (TE) 
bit in the CB is also set. 

Forward Age Link (Address OxD [23:0], 24 bits) 

Link to the next CB by age in the search chain. 
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Reverse Age Link (Address OxE [23:0], 24 bits) 

Link to the previous CB by age in the search chain. 

5 Transport AH Handle (Address OxF [1 5:0], 1 6 bits) 

This is the Transport AH SA handle for the CB. It is valid when the Transport AH 
(NA) bit in the CB is also set. 

1 0 Transport ESP Handle (Address OxF [31:16], 16 bits) 

This is the Transport ESP SA handle for the CB. It is valid when the Transport ESP 
(NE) bit in the CB is also set. 

15 TCP Congestion Control Support 

Overview 

The IT10G implements Slow Start, Congestion Avoidance, Fast Retransmit, Fast 
20 Recovery Algorithms, Window Scaling, as well as re-ordering of out-of-order packets 
in hardware. In addition, the IT 10G supports a Round Trip Time TCP option which 
enables more then one segment to be timed at a time. These features are needed 
for high-speed networks. 

25 Round Trip Time Measurement 
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The IT10G is capable of measuring Round Trip Times (RTT) in two ways. In the 
traditional method, a time measurement is taken from a TCP PSH packet to when 
the ACK for the packet is received. The sequence number of the timed packet is 
stored in the Sequence Number of Timed Packet field in the CB, and the timestamp 
5 for the packet is stored in the Timestamp of Last Transmission field in the CB. When 
the ACK for the timed packet is received, the delta between the current timestamp 
and the stored timestamp is the RTT. When the ACK is received, the RTO[1] bit in 
the socket CB is cleared to indicate that the next packet may be timed. 

10 When the RT option is negotiated for in the opening TCP handshake, then the RT 
measurement may be taken form each ACK received. 

Regardless of the method used to obtain a round trip time measure, the logic flow 
that takes that value and determines the Retransmission Timeout (RTO) value is the 
15 same. This logic is depicted in Figure 29. 

The scaled smoothed RTT, mean deviation, and RTO are all stored in the socket 
CB. 

20 Slow Start Algorithm 

Slow start is a TCP congestion control mechanism first mentioned in RFC1122 and 
further described in RFC2001 http://www.rfc-editor.org /rfc/rfc1 1 22.txt and 
http://www.rfc-editor.ora/rfc/rfc2001.txt . 
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Slow Start slowly ramps up the number of data segments in flight at one time. 
Initially slow start should only let two data segments (corresponding to a current 
window, cwnd, of twice the maximum segment size, or 2 * MSS) fly before expecting 
an acknowledgemment (ACK). For each successful ACK received the transmitter 
can increase cwnd by 1 MSS (thus allowing one more segment in flight) until cwnd is 
equivalent to the receivers advertised window. 

Slow start is always started on a new data connection, and sometimes is activated in the 
middle of a connection when a data traffic congestion event happens. Slow start is used 
to get things going again. 

The network stack supports the Slow Start algorithm for every TCP connection. This 
algorithm uses a congestion window parameter (cwnd), which is initialized to 1 MSS 
when the socket is first established. 

The Slow Start algorithm dictates that when the socket is initially established, that 
only one packet can be sent out, and no further data can be transmitted until the 
ACK for the packet is received. When the ACK is received, the cwnd is then 
increased by 1 MSS, which allows up to two packets to be transmitted. Each time an 
ACK is received, the cwnd is increased by 1 MSS. 

This continues until cwnd surpasses the advertised window size from the peer. The 
network stack always sends the minimum of the cwnd and the advertised window. 
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If the network stack receives an ICMP source quench message, then it resets the 
cwnd back to 1 MSS. The slow start threshold variable (ssthresh) is kept at its same 
value however. 

5 Congestion Avoidance Algorithm 

The network stack keeps sending out the minimum of the cwnd and the advertised 
window from the peer. The congestion avoidance algorithm also uses the slow start 
threshold variable (ssthresh), which is initialized to OxFFFF. 

10 

When congestion is detected via a timeout, then ssthresh is set to one-half the 
current transmit window (minimum of the cwnd and the peer's advertised window). If 
this value is less then twice the MSS, then this value is used instead. Also cwnd is 
set to one MSS. 

15 

When new data is acknowledged, the cwnd is increased by 1 MSS until it is greater 
then ssthresh (hence the name). After that, cwndls increased by Mcwnd. This is the 
Congestion Avoidance phase. 

20 Fast Retransmission and Fast Recovery Algorithms 

Fast retransmit was first mentioned in RFC122 as an experimental protocol and was 
formalized in RFC2001 , see http://www.rfc-editor.org/rfc/rfc1 1 22.txt and http://www.rfc- 
editor.org/rfc/rfc2001 .txt . 

25 
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Fast retransmit immediately generates an ACK when an out of order segment is 
received to allow the sender to quickly fill the hole instead of waiting for standard 
time out. 

Fast retransmit is invoked when a receiver receives three duplicate ACKS. When 
fast retransmit is invoked the sender tries to fill the hole. A duplicate ACK is 
considered duplicate' when the ACK and window advertisement values in a segment 
match one another. 

When the network stack receives duplicate ACKs it is a strong indication that a 
packet has been dropped. When n duplicate packets are received, then the dropped 
segment is immediately retransmitted even though its retransmission timer may not 
have expired yet. This is the Fast Retransmission algorithm. The number, n, of 
duplicate ACKs that must be received before the retransmission may be set via the 
TCP_Dup_ACK register (0x36), and defaults to three. 

When the specified number of duplicate ACKs is received, ssthresh is again set to 
one-half the current window size as was the case with the Congestion Avoidance 
algorithm, but this time cwnd is set to ssthresh + (3 * MSS). This ensures that we 
revert back to the Congestion Avoidance algorithm and not Slow Start after receipt of 
duplicate ACKs. Each time another duplicate ACK is received, cwnd is increased by 
one MSS. This is the Fast Recovery Algorithm. 

When an ACK for new data is received, then cwnd is set to ssthresh. 

Retransmission Theory of Operation 
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Retransmission support in logic resides in three locations: where data is sent, in 
processing received ACKs, and in the CB Poller 

5 Data Transmissions 

When we send data, the transmission logic looks at the retransmission valid bit in the 
associated CB. If the bit is not set, implying no valid retransmission time is stored, 
then the currently stored RTO (in the CB) is added to the current timestamp. The 
10 resulting time is the retransmission time for the packet. This time is stored in the CB 
and the retransmission valid bit in the CB is set. 

If the retransmission valid bit was already set in the CB, it means that there are 
currently outstanding data on the socket and the retransmission time does not need 
15 to be updated here. 

If the data buffer being sent is due to a timeout and thus is a retransmission, then the 
retransmission time in the. CB is always updated, and the RTO stored in the CB is 
also adjusted (doubled). 

20 

ACK Processing 

When the TCP RX module receives ACKs it sends a notification to the TX module, 
along with the timestamp of the ACK (if included). The TX module uses this 
25 information to update the RTO. This update is not done if the ACK was in response 
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to a retransmitted packet. The indication of whether the packet was retransmitted or 
not is kept in the data buffer header in MTX memory. 



If a new RTO is needed after it is calculated, it is stored in the CB. If any outstanding 
5 data on the socket is detected, then a new retransmission time is also calculated, by 
adding the new RTO to the current timestamp, and this is also stored in the CB. 

CB Poller 

10 The CB poller cycles through all CBs looking for active blocks. When the CB poller 
finds an active block, the CB poller examines the retransmission valid bit. If the 
retransmission valid bit is set, then the CB poller compares the retransmission time. 
If the CB poller finds that the retransmission time has expired, then the CB poller 
asserts the retransmit bit in the CB (that is how the data transmitter knows the 

1 5 packet is a retransmitted packet), and places the CB onto one of the priority queues. 

MSS Selection 
Overview 

20 

This section outlines how the MSS option is derived. 
Initial Setup 

25 Prior to enabling TCP transactions, the host should set up the following parameters 
and settings. 
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• The default non-local MSS to be used in registers 0x1 A4A - 0x1 A4B. 

• The default local MSS to be used in registers 0x1 A4C - 0x1 A4D. 

5 Selection Algorithm 

When selecting which of the two MSS values to use for any connection, the TCP 
engine queries the IP Router. If the destination route is through a gateway, then the 
non-local MSS is used. 

10 

TCP Options 
Overview 

15 The following discussion outlines the TCP options supported and their formats. The 
four options that are supported are: 

• MSS 

• Window Scaling 
20 • Timestamp 

. SACK 

MSS Option 
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This option is always sent. The actual MSS value used is determined according to 
the algorithm already explained. The format of the MSS option is shown in Figure 
30. 

5 Window Scaling Option 

This option is always sent in SYN packets as long as the SI_Win_En bit is set in the 
TCP_Control register. This option is sent in SYN/ACK packets only if the option was 
included in the SYN packet that generated the SYN/ACK response. The format of 
10 the option is shown in Figure 31 . Note that this option is always preceded by a NOP 
byte so that the option aligns on a four-byte boundary. 

Timestamp Option 

15 This option is always sent in SYN packets, if the timestamp option is enabled, and is 
sent in SYN/ACK packets only if the option was included in the SYN packet that 
generated the SYN/ACK response, regardless of whether the timestamp option was 
enabled or not. The format of the option is shown in Figure 32. Note that the option 
is always preceded by two NOP bytes so that the option aligns on a four-byte 

20 boundary. 

Selective ACK (SACK) Option 

Selective Acknowledgement (SACK) allows TCP to acknowledge data that contains 
25 holes (missing data packets), and allows the retransmission of only lost data, not all 
data after the drop. This feature is described in RFC2018. 
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This option is always sent in SYN and SYN/ACK packets as long as the SACK_En 
bit is set in the TCP_Control register. SACK uses two different TCP Option kinds. 
One option kind is used in the SYN packets, and the other option kind is used in data 
5 packets. The formats of the option are shown in Figures 33 and 34. 

MTX Buffer Header Formats 

Overview 

10 

This section describes the header formats that are used at the start of every MTX 
data buffer. The header contains information on the data contained in the buffer 
such as the checksum, sequence number, next link, and so forth. The header format 
is different for TCP and UDP. 

15 

Keep Alive Timer for TCP 
Overview 

20 This section describes the keepalive timer used for TCP connections. This section 
contains the theory of operation on how this feature is implemented in the IT 10G 
network stack. 

Keep Alive Parameters 

25 

The following parameters are used for the keepalive feature in the network stack: 
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Table 24 Keep Alive Parameters 



Parameter 


Description 


Default Value 


Keep Alive Enable 


Enable bit for the keep alive 
function. If the feature is not 
enabled, then an idle socket 
will stay up until it is closed in 
the regular manner. 


off 


Keep Alive 
Time[7:0] 


This fields represents the 
number of minutes that must 
elapse on an idle connection 
before a keep alive probe is 
sent on the socket. 


0x78 (120 
minutes or 2 
hours) 


Keep Alive Interval 
[7:0] 


This field represents the time 
interval in number of minutes 
between keep alive probes on 
a single socket. 


0x02 (2 minutes) 


Keep Alive 
Retries[3:0] 


This field represents the 
number of keep alive probes 
that are sent before assuming 
that the connection has been 
terminated. 


OxOA (10 retries) 



5 Theory of Operation 
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By default, the keepalive timer is disabled for a socket. When the socket is created, 
the host has the option of setting the Keep_Alive bit in the Socket_Configuration 
register. If this bit is set, and the socket parameters committed, then the keepalive 
feature is enabled for that socket. 

5 

Once the socket is established, a keep_alive timestamp is kept in its CB (word 
0x05). This timestamp represents the time in the future for when the socket is 
considered idle. Every time a packet is sent on the socket or when a packet arrives 
on the socket, this timestamp is updated. The updated timestamp is the current 
10 running minute counter plus the keep_alive time (as entered by the host via the 
Keep_Alive_Timer register (0x1 A3A). 

The CB poller module checks the Keep Alive timestamp once a minute in each CB 
that has the keepalive feature enabled. If the CB poller module finds a socket whose 

15 timestamp matches the current free running minute counter, then the CB poller 
module schedules a keepalive probe to be sent on the socket. The CB poller 
module does this by queuing the CB in the data transmission queue and setting the 
K bit (keep alive retry bit in word OxOB in the CB). The CB poller module also sets 
the keep alive retries field in the CB (word 0x13) to 0x1 . If the transmission queue is 

20 full, then the CB poller module increments the keep_alive timestamp in the CB so it 
again triggers the CB Poller during the next minute check. 

When the data packet generator comes across a CB whose K bit is set, the data 
packet generator sends out a one byte PSH packet with the sequence number set to 
25 one below what the sequence number should normally be set to. The data 
generator also updates the Keep Alive timestamp in the CB with the current free 
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running minute count plus the keepalive retry interval. This will cause the peer to 
send an ACK back, if it is still in operation (alive), with the correct expected 
sequence number. 

If the peer is alive and does send a response, then the TCP-RX module clears the K 
bit in the CB, reset the retry count to 0x0, and updates the keepalive timestamp. 

If the peer does not send a response within the keepalive retry interval, then the CB 
poller again comes across the socket when it is doing its once a minute keepalive 
timestamp check. If it sees that the K bit is already set, then it increments the 
keepalive retry counter by one and again reschedules the CB for a data packet 
transmission. 

If the CB poller finds that the number of retries has reached the maximum number, 
then the CB poller sends a notification to the host computer and deprecates the 
socket. 

If in the course of sending out keepalive probes, the network stack receives a RST 
packet, then this most likely means that the peer was rebooted (reset or restarted) 
without properly closing the socket. In this case, the socket is deprecated. 

Another possibility is that the network stack receives ICMP error messages in 
response to the keepalive probe, e.g. network unreachable. This situation may be 
caused by an intermediate router going down. In this case, the ICMP messages are 
sent to the on-chip processor. After receiving a number of these ICMP messages, 
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the on-chip processor can read the sockets CB, and see that it is in the keep alive 
retry state. The on-chip processor can then instigate the CB deprecation process. 



TCP ACK Modes 

5 

Overview 

The following discussion details the TCP ACK modes available in the IT10G network 
stack. There are two bits that determine in which of four modes the stack is 
10 operating. These are the Dly_ACK bit in the TCP.ControM register and the 
Host_ACK bit in the Socket_configu ration register. The operating matrix is shown in 
the following table. 



Table 25 ACK Operating Modes 



Host_ACK 


Dly_ACK 


Mode 


Description 


0 


0 


Normal 


Data is ACKed as soon as it is 
received. 


0 


1 


Delayed 


Data ACKs are delayed by a 
specified time. The ACK bit in the 
CB, which is used by the CB- 
Poller is set as soon as data is 
received. 


1 


0 


Host-Normal 


Data is ACKed after it is sent to 
the host, and the host has issued 
an ACK command for it. 


1 


1 


Host_Delayed 


Data ACKs are delayed by a 
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specified time. The ACK bit in the 
CB, which is used by the CB Poller 
is set after the data is sent to the 
host, and the host has issued an 
ACK command for it. 



Normal ACK Mode 

5 In this mode, data are ACKed as soon as they are received into the MRX DRAM. 
The TCP receive logic schedules the ACK by placing it in the RX to TX packet FIFO 
Buffer. The AR bit in the socket CB is not used in this mode. This is the default 
mode of the TCP module, and is enabled by de-asserting the Dly_ACK bit in the 
TCP_Control1 register. This is a global TCP setting so it applies to all sockets. 

10 

Delayed ACK mode 

In this mode, data is not ACKed immediately. Instead, when data arrives for a 
socket, the TCP receive logic sets the AR bit in the sockets CB. The CB Poller 

15 module then periodically examines all active CBs to see which ones have their AR 
bits set. When the CB Poller finds a set bit, the CB Poller schedules an ACK for that 
socket. The polling interval for looking for the AR bit may be set via the 
Del_ACK_Wait register, and is specified in terms of 2ms timer ticks. The default 
time interval is 250 ms. This mode is enabled by asserting the Dly_ACK bit in the 

20 TCP_Control1 register. It is also a global TCP setting so it applies to all sockets. 
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Host-Normal ACK Mode 

In this mode, data is not ACKed when it is received into the MRX DRAM. Instead, 
ACKs are only transmitted after the data has been sent to the host computer, and 

5 the host computer has acknowledged receipt of the data by issuing an ACK 
command for the data. When the IT 10G hardware receives the ACK command, it 
writes the CB, i.e. the socket handle, to the Host_ACK_CB register. This action 
causes an ACK packet to be scheduled via the RX-TX packet FIFO buffer. The AR 
bit in the socket CB is not used in this mode. This mode can be enabled on a per 

1 0 socket basis by asserting the Host_ACK bit in the Socket_Configu ration register. 

Host-Delayed ACK Mode 

In this mode, data is not ACKed immediately. Instead, after the data is received, it is 
15 transmitted to the host computer, and the host computer acknowledges the data by 
issuing an ACK command for the data. When the IT 10G hardware receives the 
ACK command, it writes the CB, i.e. the socket handle, to the Host_ACK_CB 
registers. This action causes the AR bit in the socket's CB to set. When the CB 
Poller module checks all AR bits in the next ACK polling cycle, the CB Poller 
20 schedules an ACK to be sent out for the socket. Notice that the CB polling cycle 
specified via the Del_ACK_Wait register only specifies the polling interval for the AR 
bits, and does not take into account the delay caused by first transmitting the data to 
the host computer and then waiting for the host computer to acknowledge the data. 
Therefore, if this mode is used, it is suggested that the ACK polling interval to be set 
25 to some value lower then the default 250 ms. The optimum interval is dependent on 
the host computer turnaround time for issuing the ACK command. 
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Host Retransmission Mode 
Overview 

5 

The IT10G network stack is designed to either retransmit TCP data from its local 
data buffer or from host memory. This discussion details the operations when the 
network stack is operating in the latter mode. The advantage of retransmitting out of 
host memory is that the amount of local transmission buffer memory can be kept to a 
10 minimum. This is because as soon as data are transmitted on the wire, the MX data 
buffer blocks are released. The drawback is that it takes more host memory, more 
host CPU cycles, and greater latency to support host memory retransmissions. 

Host Retransmission Mode Enabling 

15 

The host retransmission mode can be enabled on a per socket basis by asserting 
the Host_Retrans bit in the Socket_Configuration2 register. This mode can be used 
in conjunction with any of the ACK operating modes. 

20 Host Retransmission Mode Theory Of Operations 

When operating in host retransmission mode, it is up to the host CPU to keep track 
of sequence numbers. In each data section that is DMA'ed from host memory, the 
first 128 bits form the header for the data block. 

25 
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The host should write this header as the first 128 bits of each data transfer. 
Bits[1 27:64] of the header should be the first 64-bit word DMA'ed, followed by 
bits[63:0] of the header, followed by the first data byte. 

5 When the IT10G hardware generates the data packet, it takes the sequence number 
for the data buffer header instead of from the socket CB. The IT10G hardware then 
forms the packet up as usual, and transmits the data packet onto the wire. After the 
packet has been transferred, the MTX data buffers are freed immediately. 

10 When an ACK for data is received from a peer, the host computer is notified via a 
status message as to which CB received data, and what the received ACK number 
was. With this information, the host computer may determine when it is clear to free 
the data from the host computer memory. 

15 The retransmission timer is still used in the socket CB as under normal conditions. 
When the retransmission timer expires, a status message is sent to the host 
computer with the corresponding socket handle. The host computer then schedules 
a DMA transfer for the oldest data that it has in its memory that has not been ACK'ed 
yet. 

20 

Peer Zero Window Case 
Overview 

25 At times, the peer side of a TCP connection may run out of receive buffer space. In 
this case, the peer advertises a window size of 0x0000. The peer's window is 
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always written to the socket CB by the TCP receive section. When the receive logic 
detects a window size of 0x0000, it sets the ZW bit in the CB flag word (bit[19] of 
word 0x02). The next time that data are to be sent on this socket, the TCP transmit 
logic comes across the ZW bit being set, and instead of sending out the data, sends 

5 out a one-byte data packet with an incorrect sequence number. The sequence 
number is one less then the correct sequence number. This data packet looks like 
the keepalive probe packet. In response to this incorrect data packet, the peer 
should send an ACK packet with an updated window size. After the one-byte data 
packet has been sent, the CB zero_window probe count is incremented by one 

10 (bits[27:24] of word 0x13), and the CB zero_win_timestamp (bits [31:26] of word 
OxOC) written to when the next zero_window probe should be sent. 

Zero_Window Timestamp 

15 This field is used to determine when the next zero_window probe should be 
transmitted. Every time a zero_window probe is sent, the probe count is 
incremented, and the timestamp updated. The transmit logic determines the next 
zero_window timestamp by shifting the zero_window_interval count by the number of 
probes sent, and then adding this time to the current free running second timer. The 

20 resulting timestamp represents the time in the future for when the next probe is 
transmitted. Therefore, with the default value of three seconds, probes are sent out 
at 0, 3, 6, 12, 24, 48, and 60 second intervals. Once the interval reaches 60 
seconds, it is capped. 

25 In the CB Poller module, the logic polls all active CB ZW bits every X seconds, 
where X is the zero_window_interval count. When the CB Poller comes across a CB 
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whose ZW bit is set, the CB Poller then reads the zero_window_timestamp and 
compares the timestamp to the free running second timer. If these match, then a 
zero-window probe is queued to be sent. Unlike keepalive probes, there is no limit to 
the number of zero-window probes that may be sent. 

5 

Opening of the Window 

When a peer's window finally opens, the peer either sends an unsolicited ACK 
(window announcement), or the peer indicates the opened window in the ACK 
10 response to a zero-window probe. The TCP receive logic then updates the peer's 
window in the CB. The next time that the CB comes up for a zero_window probe, 
the CB poller sees that the window has opened. The CB Poller then clears the ZW 
bit, and schedules a regular data transfer. The number of zero_window retries is 
also reset back to 0x0. 

15 

Nagle Operations 
Overview 

20 This section describes the IT10G hardware support for the Nagle Algorithm. This 
algorithm states that when a TCP connection has un-ACKed data in transit, that 
small segments cannot be sent until the data has been acknowledged. 

Nagle Send IBs 

25 
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Separate Send Instruction blocks are provided for Nagle algorithm use. These 
instruction blocks (IBs) are similar to the regular non-Nagle IB's except that they 
have the msb of the IB code asserted. The Nagle SendlB for 32-bit addressing is 
0x81 and the code for 64-bit addressing is 0x82. The Nagle Send IBs work in the 
5 same way as regular Send IBs except that when they are parsed by the HW, the 
RxACK bit in the Sockets CB is asserted. Processing of regular Send IBs clears this 
bit if it is set. 

RxACK Bit 

10 

This is a bit that resides in the socket CB and may be set via an application by 
asserting bit [3] in the Socket_Confg1 register. When set, this bit causes an 
RX_ACK status message to be generated when an ACK is received that 
acknowledges all outstanding data. This condition is met when the received ACK 
15 number matches the SEQ number to be used by the socket. The status message 
code is 0x16 for Received ACKs. 

The RxACK status bit is cleared when a regular Send IB is processed by the IT1 0G 
hardware or when an RxACK Status message is sent or by the application manually 
20 clearing the bit in the socket CB. The last case is implemented for diagnostic 
purposes only. 

MTX Data Storing 

25 Overview 
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This section describes the algorithm that the TOE uses to determine the size which 
data can be stored in an MTX buffer. This affects the size of TCP packets that are 
transmitted as one MTX buffer corresponds to one TCP packet. 

5 MSS vs. one-quarter MSS (or half the Maximum Peer Window) 

If the peer's advertised window ever exceeds 2x the MSS, then the socket MSS size 
(as stored in CB location 0x05) is used as the sockets determining factor in how 
many bytes can be stored in an MTX buffer. If the peer's advertised window never 
10 reaches the twice-MSS level, then the maximum number of bytes that are stored in 
an MTX buffer is one-quarter the MSS or one-half the peer's maximum advertised 
window (depending on the implementation). The bit that keeps this comparison is 
bit[1 8] of CB word 0x14. 

15 Packet Overhead 

From either the MSS or one-quarter MSS or half PeerMaxWin value (depending on 
the implementation), the fixed byte overhead is subtracted out. This overhead 
includes packet header bytes, and IPSEC overheads. 

20 

CB Size Limit versus Buffer Size 

After the determination of whether to use the MSS or one-quarter MSS or half 
PeerMaxWin (depending on the implementation) has been made and the packet 
25 overhead subtracted out, the logic looks at what sort of buffers are available. If only 
128 byte buffers are available, then this may limit the storage size. Also, if, after the 
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above calculations, the data size is still bigger then the big MTX buffer size, then 
again, the packet size may be limited by the size of the MTX buffer. 



IP Router 



IP Router Features 



• Provides default routing capabilities 

• Provides routing for multiple host IP addresses 

• Provides host-specific and network-specific routes 

• Dynamically updates routes after ICMP redirects 

• Handles IP broadcast addresses (limited, subnet-directed and network- 
directed broadcasts) 

• Handles IP loop back addresses 

• Handles IP-multicast addresses 

Module Block Diagram 

Figure 35 is a block schematic diagram of the IP Router. 
IP Router Theory of Operation 
Requesting a route 

When the local host wishes to transmit an IP packet, it must determine where to 
send that packet, either to another host on the local area network, to an external 
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network, or back to the local host itself. It is the task of the IP router, to direct 
outgoing IP packets to the appropriate host. 



When a transmitting module requests a route, the transmitting module passes the 
5 destination IP address of a packet to the IP router. The IP router then compares the 
targeted IP address with a list of destinations stored in the IP route list. If a match is 
found, the IP router then attempts to resolve an appropriate Ethernet address. The 
IP router performs this resolution by requesting an ARP lookup for a destination IP 
address in the ARP cache. If the destination Ethernet address is resolved, the 
10 Ethernet address is passed back to the transmitting module, which uses this 
Ethernet address as the destination of the outgoing Ethernet frame. 

Route information is provided by three separate components: the default route 
registers 351, the custom route list 352, and the unrouteable addresses cache 353. 
15 These components are all queried simultaneously when a route request is served. 

The Default Route 

Packet destinations are can be described as being either local or external. Local 
20 destinations are attached to the same local area network as the sending host. 
External destinations belong to networks separate from the sending host's local area 
network. 

When an outgoing packet destination IP address is found to belong to a host 
25 attached to the local area network, the IP router uses ARP to attempt to establish 
resolve the destination IP address to its corresponding Ethernet address. If a 

171 



WO 03/105011 PCTAJS03/18049 

destination IP address is determined to belong to an external network, the IP router 
must determine which gateway host to use to relay outgoing packets to the external 
network. Once a gateway host has been selected, outgoing IP packets use the 
Ethernet address of the gateway host as their destination Ethernet address. 

In the event that a route cannot be found for a packet destination IP address, that 
packet must use the gateway host specified by the default route. The default route is 
used only when no other routes can be found for a given destination IP address. 

To minimize the number of accesses to the ARP cache, the IP router caches the 
default gateway Ethernet address when the default route is set. The default gateway 
Ethernet address is cached for a maximum amount of time equal to that of dynamic 
entries in the ARP cache are allowed to be cached. 

Broadcast and Multicast Destinations 

When the destination IP address is a broadcast or multicast IP address, an ARP 
lookup is not needed. Instead, destination Ethernet addresses are dynamically 
generated depending on the type of IP address. Packets with the destination IP 
address set to the IP broadcast address (255.255.255.255) are sent to the Ethernet 
broadcast address (FF:FF:FF:FF:FF:FF). Packets with the destination IP address 
set to a multicast IP address (224.x.x.x) have their destination Ethernet addresses 
computed from the multicast IP address. 

Static Routes 
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In addition to the default route, the IP router allows the creation of static routes to 
map destination IP addresses to specific Ethernet interfaces or gateway hosts. An 
IP route entry includes a destination IP address, a netmask and a gateway IP 
address. The netmask is used to match a range of destination IP addresses with the 
5 destination IP addresses stored within the IP route entries. The netmask also allows 
differentiation between routes for specific hosts and routes for networks. The 
gateway IP address is used when resolving a destination Ethernet address via ARP. 

Because it is possible to have a large number of routes in the IP route list, IP route 
10 entries are stored in dynamically allocated memory (called ml memory in this 
implementation). Each IP route entry uses 128 bits. The last 32 bits of each entry 
do not store any data, but are used as padding to align IP route entries along 64-bit 
boundaries. The format of each IP route entry is shown in Figure 36. 

15 The IP route list is implemented as a sorted linked-list. As IP routes are added to the 
IP route list they are ordered according to their netmasks, with the most-specific IP 
routes appearing at the front of the list and IP routes with the least-specific netmasks 
going to the end of the list. The route pointer field in an IP route entry contains the 
ml memory address where the next IP route entry can be found in ml memory. The 

20 first (most significant) bit of the route pointer field is used as flag to determine if the 
ml memory address is valid and there is a route following the current one. If the 
pointer valid bit of the route pointer field is not asserted, then there are no further IP 
routes in the IP route list and, the end of the IP route list has been reached. 
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If a destination IP address is not determined to be a broadcast or multicast IP 
address, the IP route list is searched for a matching IP route entry. If a match is not 
found in the IP route list, the default route is used to provide the gateway information. 

5 The IP router also allows for the use of multiple physical and loopback interfaces. 
Using the interface ID field in the IP route entry, the IP router can direct outgoing 
packets to a particular Ethernet interface of the IT 10G. The interface ID field is also 
used for directing ARP requests to the appropriate Ethernet interface. 

1 0 Loop back Add resses 

If the destination IP address belongs to the IT 10G, or is a loop back IP address 
(127.x.x.x), the outgoing packet is supposed to be fed back to the IT 10G. IP routes 
for loop back destinations are stored in the IP route list. IP addresses not assigned 
15 to the IT 10G may also be configured as loop back addresses. To enable this local 
redirection, the interface ID field of the IP route entry should be set to 0x8. 
Otherwise, the interface ID field of the IP route entry should be set to one of the 
Ethernet interfaces (0x0, 0x1, 0x2, and so forth). 

20 Creating Routes 

New IP routes may come from the system interface (the host computer for example). 
IP routes created by the system interface are static routes, meaning that they remain 
in the table until they are removed by the system interface. The system interface 
25 adds and removes routes via the IP router module register interface. 
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ICMP redirect messages are transmitted when IP packets are being sent to the 
incorrect gateway host. An ICMP redirect message normally contains information for 
the correct gateway host to use for the incorrectly routed IP packets. When an ICMP 
redirect message is received, the message is processed by the system interface. It 
5 is up to the system interface to update the route list via the IP router's register 
interface, updating an existing IP route or creating a new IP route. 

Routing to Hosts on the Local Network 

10 To route packets directly to other hosts on the local Ethernet network, an IP route 
with the IT 10G subnet mask must be created. Instead of specifying another host as 
the gateway for this route, the gateway IP address should be set to 0.0.0.0 to 
indicate that this route results in a direct connection across the local network. 

15 Route Request Signaling 

Each transmitting module has its own interface into the IP router for requesting 
routes. The signaling used to request and receive a route is illustrated in Figure 37. 

20 When a module is requesting an IP route, the requesting module asserts a route 
request signal (TCP_Route_Req for example), and provides a destination IP address 
(TCP_Trgt_IP in Figure 21) to the IP router. Once the IP router has found a route for 
the supplied IP address, the IP router asserts a route done signal and outputs a 
destination Ethernet address. The route_valid signal is used to indicate to the 

25 transmitting module if an IP route was found successfully. If the route_valid signal is 
asserted when the route done signal is asserted, then a valid route was found. If the 
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route_valid signal is not asserted, that means that routing was unsuccessful. This 
routing failure could be due to several causes such as not having a default route set, 
or the gateway supplied by the matching IP route entry is down and not responding 
to ARP requests. In the event of a route failure, it is up to the transmitting module to 
5 wait and attempt to resolve the route again later, or to abort the current connection 
attempt. 

When an IP route requires an ARP lookup to resolve the Ethernet address for the IP 
address of a host or gateway, it is possible for delay to occur if that IP address is not 

10 found in the ARP cache. When there is a cache miss, i.e. target IP address does not 
have an entry in the ARP cache, the ARP cache notifies the IP router of the miss. 
The IP router then signals to the transmitting module, which requested an IP route, 
that an ARP cache miss has occurred. At this point, the transmitting module may 
choose to delay establishing the current connection, or attempt to establish the next 

15 connection in the connection queue and request another route. Even if the 
transmitting module cancels its route request to the IP router, the ARP lookup 
continues. If the target of the ARP lookup is active and responds to ARP requests 
from the IT 10G, the resolved Ethernet address of the target IP address is added to 
the ARP cache for possible later use. Note: the IP router may have multiple 

20 outstanding ARP requests. 

Displaying individual routes 

After creating static routes, the user may then read back entries stored in the route 
25 table in two ways. If the user knows the target IP address of a given route, the 
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Show_Route command code can be used to display the netmask and gateway of 
that route. 



To display all the entries within the route table, the Showjndex command may be 
5 used. Using the Routejndex register, the system interface may access the routes 
in order of specificity. More specific (host) routes are displayed first, followed by less 
specific (network) routes. For example, the IP route entry with routejndex 0x0001 
would be the most specific route in the IP route list. Note: The default is stored at 
index zero (0x0000). The Route_Found register is asserted if a route has been 
10 found successfully, and the route data is stored in the Route_Trgt, Route_Mask, and 
Route_Gw registers. 

Caching Unresolvable Destinations 

15 When the IP router is unable to resolve the Ethernet address for a destination 
host/gateway, the router then caches that destination IP address for 20 seconds. If, 
during that time, the router receives a request for one of these cached unresolvable 
destinations, the IP router immediately responds to the module requesting the route 
with a route failure. This caching of unresolvable destinations is intended to reduce 

20 the number of accesses into the shared ml memory, where the ARP cache entries 
are stored. Caching unresolvable destinations also helps to avoid redundant ARP 
requests. Note: The amount of time an unresolved address may be cached is user 
configurable via the Unres_Cache_Time register. 

25 System Exception Handler 
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Overview 

The following discussion details the System Exception handler. This module is 
called whenever there is data that the IT 10G hardware cannot handle directly. This 

5 may be unknown Ethernet type packets, IGMP packets, TCP or IP options, and so 
forth. For each of these exception cases, the primary parser, when it detects an 
exception case enables the System Exception handler. The System Exception 
handler module then is responsible for storing the data, informing the system 
interface (typically the application running on the host computer) that there is 

1 0 exception data to be handled, and passing the data to the system interface. 

Exception Handler Block Diagram 

Figure 38 is a block schematic diagram of one implementation of an Exception 
15 Handler. 

Exception Handler Theory of Operation 

Exception memory is part of the on-chip processor memory. Each of the source 
20 modules, which can generate an exception packet, has their own Exception Buffer 
Start address and Exception Buffer Length registers. This module serves to FIFO 
buffer the exception packet and queue it to be stored in the on-chip processor 
memory. An exception_fifo_full signal is fed back to each of calling modules to 
indicate that the exception FIFO buffer is full. This module can only service one 
25 exception packet at a time. In the event that a subsequent exception packet is 
received, it is held off until the previous packet is stored in memory. 
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Because the exception packets are stored in on-chip processor memory, no host 
computer access is provided through this module. 

5 Memory Allocator 1 

Overview 

This section describes the memory allocator (mallocl) used to service the IP 
10 module, ARP cache, Route Table, and on-chip processor. This Allocator is 
responsible for first dividing the M1 memory into discrete blocks, and then allocating 
them upon requests, and putting freed blocks back on a stack. 

Theory of Operation 

15 

mallocl needs to have two parameters entered prior to starting its operations. 
These are the total size of the M1 memory block, and the size of each memory 
block. Only one memory size is supported with this allocator. 

20 After these parameters are entered, the system asserts the M1_Enable bit in the 
M1_Control register. When this occurs, the allocator will start filling in block 
addresses starting from the top of the M1 memory block. That is, if the M1 memory 
block is a total of 4Kbytes deep, and the block size is 512 bytes, then the M1 
memory map looks like that shown in Figure 39. 

25 
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Four addresses are kept per M1 address location for M1 Block addresses. In 
addition to keeping the starting block addresses in memory, Mallod also contains a 
16-entry cache. Upon initialization, the first 16 addresses are kept in the cache. As 
blocks are requested they are taken off of the cache. When the number of cache 
5 reaches zero, then four addresses (one memory read) are read from memory. 
Likewise, whenever the cache fills with addresses, four addresses are written back 
to memory. This takes effect only after the allocator reads address from the M1 
memory for the first time. 

10 TX / RX / CB / SA Memory Allocator 

Overview 

This section describes the memory allocators used for the socket transmit (malloctx), 
15 socket receive (mallocrx), control block (malloccb), and SA (mallocsa) memories. 
These allocators are responsible for allocating memory blocks upon requests, putting 
freed blocks back on a stack, and arbitrating for use of the memories. 

Theory of Operation 

20 

The mallocs needs to have several parameters entered prior to starting its 
operations. These are the starting and ending address pointer locations within the 
MP memory space, and the bitmaps that represent each available blocks within each 
memory space. Two sizes of blocks are available for the socket data memories; 128 
25 bytes and 2k bytes. The CB memory has fixed 128 byte blocks. All the allocators 
also utilize an eight entry cache for block addresses for each memory size. 
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After these parameters are entered, the system asserts the Enable bits in the Control 
registers. The allocators then can start to allocate and de-allocate memory blocks. 

5 Default Memory Map 

Figure 40 depicts a sample memory map assuming 256MByte of memory, for the 
unified Network Stack Data memory, i.e. where MRX and MTX share a common 
physical memory bank. Although the current implementation employs external DDR 
10 DRAM for both MRX and MTX, in alternative implementations it is also possible to 
locate these memories on-chip or use a different type of memory (SRAM for 
example). 

Network Stack Data DDR Block Diagram 

15 

The network stack data DDR DRAM is shared between the Transmit and Receive 
data buffers and the on-chip processor. The block diagram flow for the data is 
shown in Figure 41 . 

20 The Data DDR DRAM Arbitrator 41 1 is responsible for arbitrating the access to the 
shared DDR DRAM between the different resources. The entire DDR DRAM 412 is 
also memory mapped into the on-chip processor's memory space. 

25 MTX DRAM Interface and Data Flow 
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The following discussion overviews the interface between the malloctx module and 
the Data DDR Arbitration module. It depicts the data flow, lists interface signals, and 
details the timing required. 

Data Flow 

Three different access types are supported for MTX DRAM. These are burst writes, 
burst reads, and single access. The malloctx 413 arbitrates requests from different 
sources for each of these cycle types, but all three cycle could be requested from the 
Data DDR Arbitrator simultaneously. A block diagram of the mtxarb sub unit is 
shown in Figure 42. 

Data written to MTX memory are first written to a FIFO buffer, and then burst written 
into DDR DRAM. 

RX DRAM Interface and Data Flow 
Overview 

This section describes the interface between mallocrx 414 and the receive socket 
data DRAM controller. It describes the data flow, lists interface signals, and details 
the timing required. 

Data Flow 
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For the receive DRAM, the highest priority is given to data being written to memory. 
This is because the network stack must keep up with data being received from the 
network interface. Writes to the DRAM first go into a FIFO buffer. When all data is 
written to the FIFO buffer, then the controller burst writes it to the DRAM. For jumbo 
frames, the TCP receive logic breaks the burst write requests into 2K size chunks. 

For data that is to be burst read from the DRAM, the DRAM controller reads the 
memory, and writes the requested data into a pair of ping-pong FIFO buffers that 
feed the PCI controller. These FIFO buffers are needed to transition the data rate 
from the DRAM clock to the PQI clock domain. 

Network Stack DDR Block Diagram 

The network stack DDR is shared between the CB, Miscellaneous, and SA 
memories. The block diagram flow for the data is shown in Figure 43. 

The NS DDR Arbitrator is responsible for arbitrating the access to the shared DDR 
between the different resources. 

MCB DRAM Interface and Data Flow 
Overview 
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This section describes the interface between the malloccb module and the NS DDR 
Arbitration module. It depicts the data flow, lists interface signals, and details the 
timing required. 

5 Data Flow 

Two different access types are supported for MCB DRAM. These are burst reads 
and single accesses. The malloccb arbitrates requests from different sources for 
each of these cycle types, but both cycles could be requested from the NS DDR 
10 Arbitrator simultaneously. A block diagram of the mcbarb sub unit is shown in Figure 
44. 

Network Stack Memory Map 

15 Figure 45 depicts the default memory map for the network stack. Addresses shown 
are byte addresses. 

Miscellaneous Memory 

20 

Overview 

The following discussion details the 51 2K-byte miscellaneous memory bank. This 
memory is used for the purposes listed below: 
25 • Half Open Control Blocks (Main) 
• TCP Port Authorization Table 
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• UDP Source Port Usage Table 

• TCP Source Port Usage Table 

• Time Wait Control Block Allocation Table 

• Established Control Block Allocation Table 

5 • TX Memory Block Allocation Tables (for both 1 28 and 2K byte blocks) 

• RX Memory Block Allocation Tables (for both 1 28 and 2K byte blocks) 

• FIFO bufer for TCP RX to TX packets 

• Socket Data Available Bitmap 

• Server Port Information 
10 • SA Entry Allocation Table 

Memory Organization and Performance 

The Miscellaneous Memory is shared with the CB memory. Most resources access 
15 the data in 256-bit words to minimize on accesses. 

Definition of Stored Data 

Half Open Control Blocks 

20 

These are the control blocks for half-open TCP connections. Each control block is 
64 bytes in size, and there are a total of 4K control blocks. Therefore, the total 
number of bytes needed for the Half-Open control blocks is 4K x 64 = 256K bytes. 

25 TCP Port Authorization Table 
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This table keeps track of which TCP ports are authorized to accept connections. We 
keep one bit of each of the 64K possible ports. Therefore this table uses 64K / 8 = 
8K bytes. In an alternative implementation, the TCP Port Authorization Table and the 
UDP and TCP Source Port Usage Tables may be kept on the host computer. 

5 

UDP Source Port Usage Table 

This table keeps track of which UDPP ports are available for source ports used for 
locally initiated connects. We keep one bit of each of the 64K possible ports. 
10 Therefore this table uses 64K / 8 = 8K bytes. This table should not include local 
UDP service ports as well as those ports which may be used 

TCP Source Port Usage Table 

15 This table keeps track of which port numbers are available for source ports used for 
locally initiated connections. We keep one bit of each of the 64K possible ports. 
Therefore this table uses 64K / 8 = 8K bytes. 

Time Wait Control Block Allocation Table 

20 

This is an allocation table for Time Wait Control blocks. We keep one bit for each of 
the 32K Time Wait control blocks. Therefore, this allocation table uses 32K / 8 = 4K 
bytes. This module uses the full 16 bit data bus. 

25 Established Control Block Allocation Table 
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This is an allocation table for Established Control Blocks. We keep one bit for each 
of the 64K control blocks. Therefore, this allocation table uses 64K / 8 = 8K bytes 



TX Socket Data Buffer Block Allocation Table 

5 

This table is made up of a 2-Kbyte block allocation table and a 128-Kbyte block 
allocation table, that are used for the dynamically allocated Transmit Data buffer 
memory. The number of blocks of each type is configurable, but the size of both of 
the allocation tables combined is fixed at 72 Kbytes. This allows for a maximum of 
10 475K 128 byte blocks. At this level, the number of 2-Kbyte blocks is 98K. 

RX Socket Data Buffer Block Allocation Table 

This table is made up of a 2-Kbyte block allocation table and a 128K byte block 
15 allocation table, that are used for the dynamically allocated Receive Data buffer 
memory. The number of blocks of each type is configurable, but the size of both of 
the allocation tables combined is fixed at 72 Kbytes. This allows for a maximum of 
475K 128-byte blocks. At this level, the number of 2-Kbyte blocks is 98K. 

20 TCP RX FIFO Buffer 

This FIFO Buffer is used to keep track of packet transmission requests from the TCP 
Receive Logic to the TCP Transmit logic. Each TCP RX FIFO Buffer entry is made 
up of some control flags, and a Control Block address, for a total of four bytes (four 
25 flags, a 26-bit address, and two unused bits). This TCP RX FIFO Buffer is 1024 
words deep, and therefore requires 1024 x 4 = 4 Kbytes. 
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Socket Data Available Bitmap 

This bitmap represents which of the 64K sockets has data ready to be sent to the 
5 host system. We keep one bit for each of the sockets. Therefore, this bitmap 
requires 64K / 8 = 8K bytes. 

SA Entry Allocation Table 

10 This is an allocation table for SA Entries. We keep one bit for each of the 64K SA 
Entries. Therefore, this allocation table uses 64K / 8 = 8K bytes 

Server Port Information 

15 This database is used to store parameter information for TCP ports that are opened 
in the LISTEN state. Because these server ports do not have CBs associated with 
them until they are opened, the port specific parameters are kept in this area. Each 
port entry is made up of 2 bytes, and there are 64K possible ports. Therefore, this 
database requires 64K x 2 = 128K bytes. 

20 

Miscellaneous Memory Map 

The memory map used for the miscellaneous memory is configurable. The default 
settings are shown in Figure 46. Note: Blocks are not to scale. 

25 

MiscMem Theory of Operation 
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Module Initialization 



There is little that the CPU needs to initialize prior to. activating the miscellaneous 
5 memory arbitrator. If the default memory map is to be used, then the CPU can 
enable the arbitrator by asserting the MM_Enable bit in the MiscMem_Control 
register. 

If a non-default memory map is to be used, then all the base address registers 
10 should be initialized prior to enabling the arbitrator. It is the responsibility of the host 
computer software to ensure that the base addresses programmed do not cause any 
overlapping memory areas. No hardware checking for this is provided. 



CPU Access 

15 

The CPU can access any location in the miscellaneous memory. It does this by first 
programming in an address into the MM_CPU_Add registers (0x1870 - 0x1872), 
and then reading or writing a byte to the MM_CPU_Data register (0x1874). The 
address registers auto- increments every time the data register is accessed. 

20 

MIB Support 



Overview 
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This section describes the MIB support built into the IT 10G network stack. It 
contains register definitions, theory of operations, and an overview of what MIBs are 
used for. 

5 SNMP and MIB Introduction 

SNMP is a management protocol that allows SNMP management stations to get 
statistics and other information for network-connected devices and also allows a 
device to be configured. The software that runs on a device is called an Agent. The 

10 Agent runs on top of a UDP socket and handles requests from an SNMP 
management station. The Agent can also send traps to the SNMP Management 
Station when certain events occur on the device. The SNMP RFCs document a set 
of standard information objects that when grouped together, are called a 
Management Information Base (MIB). Vendors can also define there own MIB's that 

15 they may support in addition to the applicable standard MIBs defined in the RFCs. 

The standard MIBs define information that most devices of the types specified 
should provide. Some of the information can be handled completely by the SNMP 
Agent software; the rest require some level of support from the operating system, 
20 drivers and devices. SNMP support takes place in all three of our major deliverables, 
the Hardware, Embedded Software, and Driver. 

In most cases hardware support is limited to statistical information collection for 
certain counters that are relevant to the networking layers we have implemented in 
25 hardware. Interrupts can also be triggered on certain events. The embedded 
software development also supports certain counters for the layers implemented in 
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software, such as ICMP, Exception handling, etc. In addition, the embedded 
software can query the databases created by the hardware to be able to report on 
things such as ARP table entries, TCP/UDP Socket States and other non-counter 
statistical data. Driver support is focused around interfacing the embedded platform 
5 to an API that can return the relevant objects to the SNMP agent and to allow an 
SNMP Agent some level of configuration. 

MMU and Timer Modules 

10 Overview 

The following discussion provides an overview of the general-purpose timers and 
MMU used in the system. 

15 CPU Timers 

Four general purpose 32-bit timers that can either be cascaded from the previous 
timer, or be independent are provided. All timers are capable of being operated in 
single shot or loop modes. In addition, a clock prescaler is provided that can divide 
20 down the main core clock prior to it being used by each of the timers. This allows 
minimum code changes for different core clock frequencies. 

Timer Test Mode 

25 Each of the individual timers can be put into a test mode by asserting the Timer_Test 
bit in the corresponding Timer control registers. When this mode is activated the 32 
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bit counter increments at different rates depending on the three Isb's of the 8 bit 
Clock Divider setting. 



On-chip Processor MMU 

5 

The on-chip processor uses an MMU to break up the 4-GByte memory space of the 
processor into different regions. Each region can individually specified with a base 
address and an address mask. The regions may also overlap, but in that case the 
data read back from the shared memory area is unpredictable. 

10 

On-chip Processor DRAM Interface and Data Flow 
Overview 

1 5 This section describes the interface between the on-chip processor and the Network 
Stack (NS) Data DDR Arbitration module. It depicts the data flow, lists interface 
signals, and details the timing required. 

Data Flow 

20 Three different access types are supported for the on-chip processor DRAM. These 
are burst writes, burst reads, and single accesses. In addition, a lock can be applied 
so that consecutive single accesses may be made by the on-chip processor without 
relinquishing the DRAM. The on-chip processor memory arbitrator arbitrates 
requests from different sources for each of these cycle types, but all three cycle 

25 could be requested from the NS DDR Arbitrator simultaneously. It is assumed that 
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only the on-chip processor itself uses the locking feature as it needs to be enabled 
via a register bit. 



Instruction / Status Block Theory Of Operations 

5 

Overview 

The following discussion outlines the theory of operations for Instruction Block (IB's) 
and Status Blocks (SBs) passing between the Host, on-chip processor, and Network 
10 Stack. It also covers the concept of MDLs. 

Individual IBs and SBs are concatenated into queues. There are IB queues and SB 
queues. Each queue has a host computer component and an on-chip processor 
component. Also, each IB queue has an associated SB queue. A matching IB and 
1 5 SB queue together form a Channel. This is depicted in Figure 47. 

NOTE: All Status and Instruction queue lengths should be multiples of 16 bytes and 
be DWORD aligned. 

20 The preferred embodiment supports four channels. For each queue (both IB and 
SB), there is a Queue Descriptor. These descriptors detail where the queues reside 
(in both Host and on-chip processor memories), along with the length of the queue, 
and the read and write offset pointers. Each queue is treated as a circular FIFO 
buffer. The parameters that define each queue are split into registers in the Host 

25 register interface for parameters that configure host memory utilization, and registers 
in the global network stack register space that define the on-chip processor memory 
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utilization. The format for the queue descriptors is shown in the following tables. 
The address offsets listed here are relative to the start of the queue descriptor 
registers 

5 The processing flow for Instruction Block queue is depicted in Figure 48. It also 
shows the relationship with the IB Parser module. 

SB Passing 

10 The block diagram depicting the data flow for Status block passing between the 
network stack, the on-chip processor, and the host computer is shown in Figure 49. 

The SB timer threshold is the major interrupt aggregation mechanism in the 
Integrated network adapter hardware. Interrupt aggregation reduces the number of 
15 interrupts between integrated network adapter and the host computer and interrupt 
reduction or aggregation of interrupts increases data throughput. 

The HW is capable of sending general SBs to the on-chip processor and socket 
specific SBs directly to the host computer. The host computer status messages 
20 include socket establish, RX DMA, CB_Create, and Socket_RST status messages. 

SB's from HW to the Host 

When socket specific events occur, the owner of the CB is determined by examining 
25 the HS bit in the socket CB structure. If the socket belongs to the host computer, 
then the CB channel number is also read from the CB. The channel number is sent 
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along with the event notification to the HW status message generator (the statgen 
module) 491. 



The statgen module forms the appropriate SB and places the SB into one of four 
5 DMA FIFO buffers 492. These FIFO buffers physically reside in the on-chip 
processor memory, and are specified by the the on-chip processor SB FIFO buffer 
address and the on-chip processor SB FIFO buffer length 

SBs from HW to the On-Chip Processor 

10 

When non-socket specific events occur, e.g. exception Ethernet packets, the statgen 
module generates the appropriate SB and sends it to the one status message queue 
defined in the on-chip processor memory. An interrupt may be generated to the on- 
chip processor at this time if the statgen_int is enabled. There is only one status 
15 message queue defined from the hardware to the on-chip processor, and all SBs go 
to this one queue. 

The SB queue actually resides in the on-chip processor memory. As entries are 
written into this memory area, they are pulled automatically into a register FIFO 
20 buffer for the on-chip processor to read via the STAT_READ_DATA registers 
(network stack global registers 0x005C - 0x005F). The on-chip processor can also 
poll to see how much data is available by reading the STAT_FIFO_FILLED register 
at 0x005A. This register returns the number of double words available in the queue. 

25 SBs from the On-Chip Processor to the Host Computer 
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When the on-chip processor needs to send an SB to one of the SB queues in the 
host, it sends it via the statgen hardware module. In this case the on-chip processor 
generates the SB in its memory, and then programs the starting address for this SB, 
the channel # for the SB, and the length of the SB to send to the statgen module. 
5 The HW then transfers the SB (or SBs) into the appropriate SB queue to the host. In 
this way, SBs from the on-chip processor and HW are intermingled in the same SB 
queues that feed the SB DMA engine 493. , 

The on-chip processor can be notified that SB has been transferred into the 
10 appropriate SB queue either via a interrupt or polling a status bit. Prior to writing any 
parameters for this function, the on-chip processor should make sure the statgen 
module has completed transferring any previous SB request, i.e. the on-chip 
processor should make sure the SB bit is not asserted in the statgen command 
register. 

15 

MDL Handling 

MDLs (Memory Descriptor Lists) are first DMA'ed from Host computer memory into 
the on-chip processor memory in the DDR DRAM. The on-chip processor passes 
20 back an MDL Handle to the host, based on the MDLs DDR Address. 

SendMDL32/64 IBs that include the MDL Handle, an offset into the MDL, and a 
transfer length are then parsed by the IB Parser and do the following. 
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Read the first entry in the MDL and figure out if the Offset specified falls within this 
entry. It makes this determination by comparing the offset with the length of the first 
MDL entry. 

5 If it does not fall within the first MDL entry then it reads the next MDL entry. When it 
finally finds the correct MDL entry, it queues a TX DMA transfer using the addresses 
in the MDL. The transfer could span multiple MDL entries from the point where the 
offset starts. 

10 When the on-chip processor gets the IB, the on-chip processor programs the offset 
into the socket CB. When the CB gets this information then it can DMA the data. 
Alternatively, if the host computer knows the offset ahead of time then we can 
program the offset into the CB ahead of time. 

15 The Transfer threshold which specifies how many bytes must be DMA'ed before an 
RX DMA status message is generated is still applicable in MDL mode. 

Instruction Blocks and Status Messages 

20 Overview 

The following discussion details the Instruction block and status message formats. 
The host uses IB's to pass commands to the IT 10G hardware, and the IT 10G 
hardware uses status blocks to pass information to the on-chip processor and the 
25 host computer. 
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Instruction Block Structure 

The only IB that the hardware parses directly is the various forms of a 
Send_Command. 

5 

HW Parsed Instructions 

These instructions are used to request the IT 1 0G hardware to transmit data, close 
or post receive parameters on a given socket. There are 4 forms of the SEND 
instruction to handle TCP, UDP, and 32 bit and 64 bit host computer memory 
10 addressing. 

iSCSI Support 

One embodiment of the IT10G uses the host computer to assemble an iSCSI PDU 
15 header, however an alternative embodiment uses the IT 10G hardware and on-chip 
processor to assemble and process the iSCSI PDUs. Both embodiments are 
described below. 

iSCSI 

20 

Overview 

This section describes the hardware support for iSCSI in the IT 10G using the host 
computer to assemble the iSCSI PDU header. The IT 10G hardware offloads the 
25 calculation of the iSCSI CRC for transmit and receive, and the hardware performs 
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iSCSI framing using Fixed Interval Markers (FIM) for transmit. Framing is not 
currently supported for receive. 



Theory of operation 

5 

The iSCSI protocol is defined in the IETF iSCSI Internet draft, which is the normative 
document for the definition of the hardware function. The iSCSI protocol 
encapsulates SCSI commands (the SCSI commands are in command descriptor 
blocks, or CDBs) in protocol data units (PDUs) carried in a TCP/IP byte stream. 
10 SCSI commands are documented in several standards. The hardware accepts iSCSI 
header segments and iSCSI data segments from the host iSCSI driver and prepares 
iSCSI PDUs for transmission. The hardware receives iSCSI PDUs, calculates the 
iSCSI CRCs, and passes the results to the host iSCSI driver. 

15 The hardware is principally concerned with the external format of the iSCSI PDU, 
which contains iSCSI header segments and an iSCSI data segment. The iSCSI PDU 
consists of a required basic header segment (BHS), followed by zero or more 
additional header segments (AHS), followed by zero or one data segments. The 
iSCSI CRCs are optional and included in an iSCSI PDU as a header digest and a 

20 data digest. The described implementation allows the iSCSI header and data to be 
separated and copied to the host computer memory, withpout requiring additional 
memory copies on the host computer. 

iSCSI Transmit 

25 

Overview 
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A block diagram of the iSCSI transmit data path is shown in Figure 50. 
iSCSI Control Module 

5 

The iSCSI control module 501 receives control signals from the TX DMA engine 
module 502, the CB access module 503, and the Statgen module 504. 

The iSCSI control module provides control signals to the CB access module, the 
10 iSCSI CRC calculation module 505, and the FIM insertion module 506. The iSCSI 
control module calculates the length of the iSCSI PDU, including any iSCSI CRC 
words and any markers, and provides the iSCSI PDU length, including any iSCSI 
CRC words and any markers, to the XMTCTL MUX module. 

15 The host iSCSI driver assembles a complete iSCSI PDU header in host memory. 
The host iSCSI driver then creates a TCP send 32 iSCSI IB or a TCP send 64 iSCSI 
IB depending on whether 32-bit addresses or 64-bit addresses are required. The 
host iSCSI driver then sends the TCP send iSCSI IB, which is received by the on- 
chip processor. The effect of the host iSCSI driver sending a TCP send iSCSI IB to 

20 the on-chip processor is to instruct the iSCSI control module to initiate a DMA 
transfer of an iSCSI PDU to a linked list of buffers in the host computer memory. 

An iSCSI PDU, including the BHS, any AHS, and any data segment, is transferred 
using a TCP send 32 iSCSI IB or a TCP send 64 iSCSI IB. 

25 
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It is difficult to design the iSCSI CRC calculation module, which must insert the iSCSI 
CRC at the end of the iSCSI PDU header segments or at the end of the iSCSI 
PDUdata segment unless an iSCSI PDU is completely contained in a single DMA 
transfer. 

5 

The overhead of using a single IB for each iSCSI PDU when iSCSI PDUs may be as 
small as 48 bytes (the BHS) is not much more than the overhead of coalescing 
iSCSI PDUs for a single DMA transfer and then separating the iSCSI PDUs for 
processing again. 

10 

The first transfer block must be a complete iSCSI PDU header or headers, I.e. a 
BHS followed by zero, one, or more AHS, and all of the header or headers are 
contained in the first transfer block. 

15 It is necessary for the first transfer block to be a complete iSCSI PDU header or 
headers in order for the CRC calculation module to be able to insert the iSCSI 
header CRC at the end of the iSCSI PDU headers. 

The iSCSI control module should check that the TCP send 32 iSCSI IB or TCP send 
20 64 iSCSI IB contains at least one transfer block. This is a necessary condition for 
correct operation. It is an error if this condition is not met and the module should fail 
gracefully. 

The iSCSI control module initiates a DMA transfer of an iSCSI PDU by making a 
25 request to the DMA engine module for permission to perform a DMA transfer. When 
the iSCSI control module request to perform a DMA transfer has been granted, the 
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iSCSI control module is given locked access to the DMA engine. The DMA engine is 
locked until all the transfer bocks in the iSCSI IB have been serviced. All transfer 
blocks in the iSCSI IB are serviced when all iSCSI header and iSCSI data 
information has been transferred from host memory to the hardware by DMA. The 
5 DMA engine signals the iSCSI control module when all iSCSI header and iSCSI data 
information has been transferred from host memory to the hardware by DMA. 

The iSCSI control module is given locked access to the DMA engine in order to 
make it easier to implement the FIM and CRC operations, taking account of the 
10 iSCSI login phase. 

Two bits in the iSCSI IB, iSCSI CRC select bit 1 and iSCSI CRC select bit 0, are set 
by the host iSCSI driver to signal the iSCSI control module if the iSCSI CRC 
calculation module should calculate the iSCSI CRC for the iSCSI header or iSCSI 
15 data, both, or neither. These two iSCSI CRC select bits may take on any 
combination of 1 and 0. 

The iSCSI IB contains a set of address and length pairs, known as transfer blocks, 
which correspond to a linked-list (LL) of buffers in host memory. The linked-list of 

20 buffers in host memory store the iSCSI header and iSCSI data information. The 
transfer blocks that are included in the TCP send iSCSI IBs provide the iSCSI control 
module information on where to find the iSCSI header and iSCSI data via this linked- 
list of buffers. The first transfer block in each iSCSI IB points to the iSCSI header in 
host memory and the remaining transfer blocks in the iSCSI IB point to the iSCSI 

25 data in host memory. 
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The iSCSI control module takes the iSCSI PDU length, including CRC words, but 
excluding markers, and calculates the length of the iSCSI PDU including any CRC 
words and any markers. The XMTCTL MUX module needs the iSCSI PDU length, 
including CRC and markers, to provide the XMTCTL module with the length of the 
5 data input to XMTCTL module. 

The XMTCTL MUX module needs the PDU length, including any CRC words and 
any markers, before storing the iSCSI PDU in MTX buffers. 

10 The iSCSI control module calculates the length of the iSCSI PDU by using the iSCSI 
PDU length, including any CRC words, but excluding any markers, that is included in 
the TCP send 32 iSCSI IB or TCP send 64 iSCSI IB. 

The calculation of PDU length, including any CRC words and any markers, uses the 
15 following information: 

• FIM interval, the marker interval in bytes 

• Current FIM count, the number of bytes since the last marker was inserted, 
20 stored in the socket CB 

• PDU length, including CRC words, but excluding markers, included in the 
TCP send 32 iSCSI IB or TCP send 64 iSCSI IB 
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The calculation of PDU length, including any CRC words and any markers, using two 
counters, the PDU length counter and the marker counter, is equivalent to the 
following: 



1 . Initialize the marker counter to zero 

2. Initialize the PDU length counter to the current FIM count 

3. Check the PDU length counter against the PDU length, including any CRC 
words, but excluding any markers 

4. If the PDU length counter is greater than the PDU length, including any CRC 
words, but excluding any markers, exit loop 

5. Add the FIM interval to the PDU length counter, increase the marker counter 
by one 

6. Go to step 3 

7. Calculate the PDU length, including any CRC words and any markers, by 
adding the length of markers, which is calculated from the marker count 



Alternative FIM algorithm: 



1 . Initialize total_marker_length to zero 

2. initializer length_counter to next marker (FIM_interval - current_FIM_count) 
3. . If length_counter > PDU_ length goto step 7 

4. increment total_marker_len by marker_size 

5. length_counter = length_counter + FIMJnterval 

6. Goto step 3 

7. xmitctl gets total_marker_len + PDU size 
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Note we must place the ending marker if a marker falls exactly after the PDU and 
must make sure that we handle the case that the current FIM count = 0 correctly. 



For the above calculation: 

5 

FIM interval comes from the CB 
Current_FIM_count comes from the CB 
1 0 total_marker_length is a temporary variable for the FIM insertion module 
length_counter is a temporary variable for the FIM insertion module 
marker_size is the total size of a FIM marker in bytes 

15 

Figure 51 shows an iSCSI Transmit Flow Chart. 

iSCSI CRC Calculation Module 

20 The DMA TX module provides an iSCSI PDU to the iSCSI CRC calculation module 
that consists of iSCSI header segments and an iSCSI data segment. 

The output from the iSCSI CRC calculation module, which is a PDU that now 
includes any inserted CRC words, is provided to the FIM insertion module. 

25 
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The iSCSI CRC calculation module calculates the iSCSI CRC value for both iSCSI 
PDU headers and iSCSI PDU data. 



The CRC calculation module inserts the iSCSI CRC at the end of the iSCSI PDU 
header or at the end of the iSCSI PDU data, or both, or neither. The calculation of 
the iSCSI CRC is controlled and indicated by iSCSI CRC select bit 1 and iSCSI 
select bit 0 in the TCP send iSCSI IBs. 

The input to the CRC calculation module is BHS, followed by zero, one, or more 
AHS, in the first transfer block, followed by zero or one data segments, in the second 
or following transfer blocks. 

The DMA engine must signal the iSCSI calculation module at the boundaries of the 
transfer blocks. The iSCSI calculation module must know where the first transfer 
block begins and ends, and where the last transfer block ends. The iSCSI header 
CRC is always inserted in the iSCSI PDU at the end of the first transfer block, if 
header CRC is enabled. The iSCSI data CRC is always inserted in the iSCSI PDU at 
the end of the last transfer block, if data CRC is enabled. 

It is critical that the first transfer block in the IB is a complete iSCSI header (BHS plus 
zero, one, or more AHS). 

FIM Insertion Module 

The FIM insertion module inserts fixed-interval markers (FIM) into the iSCSI PDUs, 
which is equivalent to inserting fixed-interval markers into the iSCSI transmit stream. 
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The FIM insertion module only inserts markers when the FIM insertion module is 
active. The FIM insertion module is active only when the FIM bit is set in the CB that 
corresponds to the current iSCSI socket (the iSCSI socket CB). 

5 

The FIM insertion module must be able to keep track of the count of the number of 
four-byte words in each iSCSI stream, including any CRC bytes that may be inserted 
by the iSCSI CRC calculation module, for each iSCSI socket. The FIM insertion 
module keeps track of the number of four-byte words by storing two FIM values in 
10 the iSCSI socket CB: the FIM interval and the current FIM count. Each of these 
fields, the FIM interval and current FIM count, is measured in four-byte words. 

The FIM interval and current FIM count can be stored in 16-bit fields. 

15 If FIM interval or current FIM count overflow there should be a graceful failure 
mechanism. 

To enable iSCSI connection setup including the iSCSI login phase, the insertion of 
markers, if markers are used, is started only at the first marker interval after the end 
20 of the iSCSI login phase. However, to enable the marker inclusion and exclusion 
mechanism to work without knowledge of the length of the iSCSI login phase, the 
first marker is placed in the iSCSI PDU stream as if the marker-less interval had 
included markers. Thus, all markers appear in the iSCSI PDU stream at byte 
locations given by the formula: 

25 

[(Ml + 8) * n - 8] 
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As an example, if the marker interval is 512 bytes and the iSCSI login phase ended 
at byte 1003 (the first iSCSI placed byte is 0) the first marker is inserted after byte 
1 031 in the stream. 

The iSCSI PDU stream is defined in the iSCSI Internet draft, but the term used in the 
Internet draft is TCP stream. FIM uses payload-byte stream counting that includes 
every byte placed by iSCSI in the TCP stream except for the markers themselves. It 
also excludes any bytes that TCP counts but that are not originated by iSCSI. 

The host iSCSI driver initializes the FIM interval and initial FIM count in the iSCSI 
socket CB by generating an iSCSI FIM interval command block. The on-chip 
processor receives the iSCSI FIM interval command block. The on-chip processor 
writes the FIM interval to the socket-specific TX_FIM_lnterval register and to the FIM 
interval field in the iSCSI socket CB. The on-chip processor writes the initial FIM 
count to the socket-specific TX_FIM_COUNT register and to the current FIM count in 
the iSCSI socket CB. 

The host iSCSI driver controls the FIM state in the iSCSI socket CB by generating an 
iSCSI set FIM state command block. The on-chip processor receives the iSCSI set 
FIM state command block. The on-chip processor then writes the FIM state to the 
FIMON bit in the iSCSI socket CB. 
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After the initialization of the FIM interval, the initial FIM count, and FIM state, the FIM 
insertion module is in the initialized state waiting for an iSCSI IB. 



It is an error to attempt to change the FIM state or initial FIM count, or the FIM 
5 interval for the current iSCSI socket while the FIM insertion module is active. 

When the FIM insertion module is in the state waiting for an iSCSI IB and an iSCSI 
IB is received, the FIM insertion module reads the FIMON bit and current FIM count 
in the socket CB. If the FIMON bit in the iSCSI socket CB is set, the FIM insertion 
10 module is active. If the FIM insertion module is active, the FIM insertion module sets 
the FIM interval counter to the current FIM count from the iSCSI socket CB. If the 
FIM insertion module is not active, the FIM insertion module returns to the state 
waiting for an iSCSI IB. 

15 The FIM insertion module is now in a state counting each four-byte word of data 
received from the CRC calculation module. After each four-byte word in the iSCSI 
PDU is received by the FIM insertion module, including any CRC bytes inserted by 
the iSCSI CRC calculation module, the FIM insertion module decrements the FIM 
interval counter by one. The FIM insertion module then returns to the state counting 

20 each four-byte word. 

When the FIM insertion module, while in the state counting each four-byte word, 
completes scanning data from an iSCSI socket, the FIM insertion module saves the 
current FIM interval counter value to the current FIM count in the current iSCSI 
25 socket CB. The FIM insertion module completes scanning data from an iSCSI socket 
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when all the transfer bocks in the iSCSI IB have been serviced. At this point the FIM 
insertion module is in a state waiting for an iSCSI IB. 



While in the state counting each four-byte word, the FIM interval insertion module 
5 inserts a marker in the iSCSI PDU when the FIM interval counter reaches zero. After 
inserting a marker in the iSCSI PDU the FIM insertion module resets the FIM interval 
counter to the FIM interval, read from the socket CB, and then returns to the state 
counting each four-byte word. 

10 A marker contains the next iSCSI PDU start pointer, which is equal to the number of 
bytes to skip in the iSCSI stream until the next iSCSI PDU header. The FIM insertion 
module must calculate the next iSCSI PDU start pointer for each marker. To 
calculate the next iSCSI PDU start pointer the FIM insertion module must count the 
number of bytes in the current PDU, measure from the start of the current iSCSI 

1 5 PDU, up to the marker insertion point, which is the current iSCSI PDU byte count. To 
count the number of bytes in the current iSCSI PDU, the FIM insertion module uses 
an iSCSI PDU byte counter. In addition to the current iSCSI PDU byte count the FIM 
insertion module must know the start position of the next iSCSI PDU header relative 
to the start of the current PDU header. The difference between the start of the next 

20 iSCSI PDU header and the start of the current iSCSI PDU header is equal to the 
current iSCSI PDU length. The FIM insertion module calculates the next iSCSI PDU 
start pointer as follows: 

Next iSCSI PDU start pointer = current iSCSI PDU length - current iSCSI PDU byte 
25 count 
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The next iSCSI PDU start pointer is 32-bits long. 

The iSCSI Internet draft defines a negotiated maximum value for the PDU data 
segment size, MaxRecvPDUDataSize, from 512 bytes to ((2**24) - 1) bytes 
5 (1 677721 6 - 1 bytes or about 1 6Mbytes). 

The current iSCSI PDU length (measured in bytes) should be at least 25 bits in 
length. 

There are several methods to provide the FIM insertion module with the iSCSI PDU 
length, including any CRC words, but excluding any markers. One way to provide the 
FIM module with the PDU length is for the iSCSI host driver to calculate the PDU 
length. 

The iSCSI host driver calculates the.current iSCSI PDU length, excluding iSCSI PDU 
header CRC or iSCSI PDU data CRC, as the sum of 48 bytes (BHS length) + 
TotalAHSLength + DataSegmentLength. 

The TotalAHSLength and DataSegmentLength must already be calculated in 
20 software as they are contained in the BHS. 

The host iSCSI driver then calculates of the current iSCSI PDU length, including any 
CRC words, but excluding markers. The current iSCSI PDU length, including any 
CRC words, but excluding markers, is equal to the iSCSI PDU length, excluding 
25 iSCSI PDU header CRC or iSCSI PDU data CRC, plus four bytes if iSCSI PDU 
header CRC is enabled, plus four bytes if iSCSI data CRC is enabled. 
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The host iSCSI driver inserts the current iSCSI PDU length, including any CRC 
words, but excluding markers, in the TCP send 32 iSCSI IB or a TCP send 64 iSCSI 
IB. See the descriptions of the TCP send 32 iSCSI IB and TCP send 64 iSCSI IB. 

5 

XMTCTL Mux Module 

The XMTCTL mux module receives TCP data from the DMA TX FIFO buffer and 
iSCSI data from the FIM insertion module. 

10 

The XMTCTL mux module provides data to the XMTCTL module from either the 
DMA TX FIFO buffer or from the FIM insertion module. 

Function: The XMTCTL mux module is responsible for multiplexing data inputs to the 
15 XMTCTL module. 

The XMTCTL mux module provides the length of the data to the XMTCTL module. 

The length of the iSCSI data must include any CRC bytes inserted by the CRC 
20 calculation module. 

The length of the iSCSI data must also include any markers inserted by the FIM 
insertion module. 

25 The XMTCTL module uses the size of the input data to break the data into 
appropriate sizes for TCP packets, based on the MSS and so forth. The XMTCTL 
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module produces appropriate size packets that will be stored in the MTX memory 
buffer. Each MTX buffer corresponds to a separate TCP packet. 



The XMTCTL mux module provides the data to the XMTCTL module in a 128-bit 
5 wide format. Data is passed to the XMTCTL module using a dav / grant handshake. 

iSCSI Receive 
Overview 

10 

The receive DMA engine includes the iSCSI receive data path. The receive DMA 
data path calculates the iSCSI CRC and pass the ending iSCSI CRC to the host 
iSCSI driver via the RX DMA status with iSCSI CRC message. 

1 5 iSCSI Receive Theory of Operation 

The hardware offloads the calculation of the iSCSI CRC. The host iSCSI driver 
controls the receive data path to ensure correct operation of the iSCSI CRC 
mechanism. 

20 

The iSCSI CRC information is transferred between hardware and the host iSCSI 
driver in two places. The ending iSCSI CRC is part of the RX DMA status with iSCSI 
CRC message sent from hardware to the host iSCSI driver. An iSCSI CRC seed is 
part of both the TCP receive iSCSI 32 IB and the TCP receive iSCSI 64 IB sent from 
25 host iSCSI driver to the hardware. 
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The host iSCSI driver must post the correct size buffers in the TCP receive iSCSI 32 
IB or TCP receive iSCSI 64 IB to keep the iSCSI CRC calculation mechanism 
operating correctly. 

5 During the iSCSI login phase the host iSCSI driver treats the iSCSI socket in the 
same manner as a normal TCP socket. When the iSCSI login phase is complete, the 
iSCSI connection enters the full-feature phase. 

When the iSCSI connection enters the full-feature phase, the connection is ready to 
10 transfer iSCSI PDUs that may contain iSCSI CRC information in either the iSCSI 
header or in iSCSI data or both. 

The RX DMA engine sends the ending iSCSI CRC calculated via the RX DMA status 
with iSCSI CRC message from the scatter-gather list specified by the TCP receive 
1 5 iSCSI 32 IB or TCP receive iSCSI 64 IB. 

Once the iSCSI login phase is complete, the host iSCSI driver posts receive buffers 
of the correct size for the iSCSI PDU header. The host iSCSI driver then parses the 
iSCSI PDU header. The host iSCSI driver then posts receive buffers of the correct 
20 size for the iSCSI PDU data segment, if there are data segments. The host iSCSI 
driver continues to post buffers of the correct size for each subsequent iSCSI PDU 
data segment. The DMA engine calculates the iSCSI CRC for each iSCSI PDU 
header segment and iSCSI PDU data segment. 

25 In the case of an iSCSI PDU header the host iSCSI driver posts a buffer of the iSCSI 
basic header segment (BHS) size (48 bytes) plus, if header CRC has been 
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negotiated during the iSCSI login phase, the size of the iSCSI PDU CRC (four 
bytes). The BHS is then transferred by DMA, including the trailing iSCSI PDU 
header CRC, if present. 

5 When the DMA transfer of the BHS is complete the RX DMA status with iSCSI CRC 
message contains the final iSCSI CRC remainder calculated by the hardware. The 
host iSCSI driver then receives the RX DMA status with iSCSI CRC message 
containing the final iSCSI CRC remainder calculated by the hardware. The host 
iSCSI driver then checks the ending iSCSI CRC in the RX DMA status to make sure 
10 that its value matches the expected remainder for this iSCSI polynomial. If header 
CRC was not negotiated during the iSCSI login phase the host iSCSI driver ignores 
the ending iSCSI CRC remainder returned in the RX DMA status with iSCSI CRC 
message. 

15 A BHS may be followed by additional header segments (AHS). Byte four of the BHS 
contains TotalAHSLength, the total length of the AHS. In the case of an iSCSI PDU 
header that contains AHS and is therefore more than 48 bytes in length, the host 
iSCSI driver generates additional TCP receive iSCSI 32 IBs or TCP receive iSCSI 64 
IBs for the AHS. 

20 

If iSCSI CRC is enabled the host iSCSI driver seeds the calculated iSCSI CRC value 
using the iSCSI CRC seed field in the TCP receive iSCSI 32 IB or TCP receive 
iSCSI 64 IB. The use of the iSCSI CRC seed field allows the rest of the iSCSI PDU 
header CRC to be checked correctly. 

25 
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In cases where a continuation of the iSCSI CRC calculation is not needed the iSCSI 
CRC seed in the TCP receive iSCSI 32 IB or TCP receive iSCSI 64 IB must be set to 
zero. 

5 When requesting an iSCSI CRC for the data section of the iSCSI PDU the host 
iSCSI driver must specify an extra four-byte data buffer to store the iSCSI CRC. 
This four-byte data buffer is inserted as the final transfer block, effectively adding an 
extra four bytes to the end of the linked-list, in the TCP receive iSCSI 32 IB or TCP 
receive iSCSI 64 IB. The four-byte data buffer allows the iSCSI CRC for the iSCSI 

10 PDU data segment to be transferred outside the iSCSI PDU data stream. The use of 
the four-byte buffer is illustrated in Figure 52. 

RX DMA Theory of Operation 

15 The host driver knows that there is RX data available when it receives an RX DAV 
status message from the hardware. This RX DAV status message notification is the 
same as regular TCP connections. The CB Handle in the RX DAV status message 
points to an iSCSI-related CB. The host driver then allocates a buffer to store the 
RX data; the total link-list buffer size should be equal to how much data the host 

20 driver expects to receive, plus CRC if expected, see Figure 52. Also, the total buffer 
size must always be aligned on a dword boundary, since iSCSI PDUs are expected 
to be in that format. The host driver must also initialize the CRC Seed to 32'hffffffff. 

When a RX DMA operation is taking place, the hardware first extracts an iSCSI CRC 
25 seed from the socket CB annex. The hardware also extracts the Host Retransmit 
(HR) bit from the Main CB Structure. The HR bit indicates to the other hardware 
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The hardware then calculates a new CRC 



The data stream may or may not contain the expected iSCSI CRC value for either 
PDU header or data segment. If the data stream does not contain an iSCSI CRC 
digest, then the iSCSI CRC calculated by the hardware is stored back into the CB 
Annex as a running iSCSI CRC. An RX-DMA Status message may or may not be 
generated. If the RX-DMA status message is generated, the status message 
contains this running iSCSI CRC. If the data stream contains an iSCSI CRC digest 
at the end, then the iSCSI CRC hardware calculates the iSCSI CRC over the PDU 
segment, including the iSCSI CRC digest (this is the expected iSCSI CRC value). If 
the PDU segment is uncorrupted and if the iSCSI CRC Digest is correct, then the 
final iSCSI CRC value, calculated by the hardware, is always equal to a fixed iSCSI 
CRC remainder. 

Once all of a posted buffer list has been filled the Statgen module generates an RX 
DMA status with iSCSI CRC message that includes the ending iSCSI CRC 
remainder. 

The on-chip processor is responsible for processing the TCP receive iSCSI 32 IB or 
TCP receive iSCSI 64 IB. During the processing of the IBs the on-chip processor will 
write the iSCSI CRC seed, which could be 32'hffffffff to signify the start of a new 
CRC calculation, or an iSCSI CRC seed from a previous RX DMA status message, 
to the socket CB annex. Writing the iSCSI CRC seed in this manner sets up the 
correct value of the iSCSI CRC. 
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For the other non-iSCSI mechanisms that use standard receive32 and receive 64 lbs 
and that rely on the RX DMA engine the CRC mechanism can be ignored and the 
CRC seed is meaningless and can be skipped. 

5 Before the RX DMA operation takes place, the peer sends one or more TCP packets 
that contain data payloads that are eventually transferred by DMA to host memory. 
Depending on how the peer's network stack operates, this payloads may be split up 
into non-dword aligned boundaries, even though iSCSI requires all PDU to align 
itself on dword boundaries. The DMA operations directly coincide to the size of 
10 each TCP packet's payloads. If the payloads are non-dword aligned, then the DMA 
operation is non-dword aligned, yet it may be needed to calculate CRC through this 
non-dword aligned data stream. The problem is that the iSCSI CRC hardware 
expects all data to be dword aligned. 

15 When the iSCSI CRC hardware comes across this corner case, it continues to 
calculate the iSCSI CRC through the non-aligned data stream. When it reaches the 
end, it stores the non-double word aligned 1-3 bytes into the CB Annex. It also 
stores the number of bytes that are valid. For example, if the data stream is 15 bytes 
long, the hardware stores the last three bytes and the number of bytes valid is three. 

20 If the data stream is 32 bytes long, then the number of bytes valid is 0 because this 
data stream is dword aligned. The information stored in the CB Annex is retrieved 
and inserted in front of the next DMA transfer. 

iSCSI Instruction Blocks 

25 
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The TCP send iSCSI instruction block (IB) is used to send an iSCSI PDU using an 
iSCSI socket. The length of the TCP send iSCSI 32 IB is variable as this IB can 
contain one or more transfer blocks that are used for a DMA transfer. A transfer 
block consists of an address (header or data) and a transfer length pair. 

The iSCSI CRC select bit 1 and iSCSI CRC select bit 0 determine the calculation of 
the iSCSI CRC by the iSCSI control module. If the iSCSI CRC select bit 0 = 1, the 
iSCSI control module calculates the iSCSI CRC over the iSCSI header. If the iSCSI 
CRC select bit = 1 , the iSCSI control module calculates the iSCSI CRC over the 
iSCSI data. The iSCSI CRC calculation can be performed by the iSCSI CRC 
calculation engine over both iSCSI header and iSCSI data, only iSCSI data, only 
iSCSI header, or neither. 

The iSCSI Total DMA Length, is the length of the entire data that needs to be 
DMAed by iSCSI Send block. It does not include the CRC length that needs to be 
calculated. 

The address and transfer length pair in the first transfer block in the TCP send iSCSI 
32 IB point to the iSCSI header in host memory. The second and any further transfer 
blocks in the TCP send iSCSI 32 IB point to the iSCSI data in host memory. 

An iSCSI PDU, including the BHS, any AHS, and any data segment, is transferred 
using a TCP send 32 iSCSI IB or a TCP send 64 iSCSI IB. 
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The first transfer block of the TCP send iSCSI 32 IB must be a complete iSCSI PDU 
header or headers, a BHS followed by zero, one, or more AHS, and all of the header 
or headers must be contained in the first transfer block of the TCP send iSCSI 32 IB. 

5 Saying the same thing a different way for emphasis: The host iSCSI driver must 
include any iSCSI data segment with the iSCSI header segments in the TCP send 
iSCSI 32 IB. The iSCSI data segment must be in a separate transfer block in the 
TCP send iSCSI 32 IB than the iSCSI header segments. 

10 The host memory address in each transfer block in the TCP send iSCSI 32 IB is 32 
bits. If 64-bit addresses are required, the TCP send iSCSI 64 IB should be used. 

The format for the TCP send iSCSI 32 IB with three transfer blocks drawn explicitly is 
shown below: 

15 

The CRC select bit 0 and CRC select bit 1 are stored in a separate word in the IB 
rather than with the unused portion of the first transfer block to make the processing 
of each transfer block similar. 

20 The TCP receive iSCSI 32 IB is used to post a buffer to be used for receive on an 
iSCSI socket. 

The length of the TCP receive iSCSI 32 IB is variable as this IB can be made up of 
an arbitrary number of transfer blocks that are used for a DMA transfer. A transfer 
25 block in the TCP receive iSCSI 32 IB consists of an address and a transfer length 
pair. 
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The iSCSI CRC seed is used to seed the iSCSI CRC engine before the DMA and 
iSCSI CRC calculation has started. The iSCSI CRC seed must be set to 32'hffffffff if 
the iSCSI CRC is requested. If iSCSI CRC is not requested, the seed value set is 
irrelevant. 

Clarification: There is no need to set the iSCSI CRC seed to zero if iSCSI CRC 
calculations are not required. 

The address length for each transfer block in the TCP receive iSCSI 32 IB is 32 bits. 
For 64-bit addressing the TCP receive iSCSI 64 IB should be used. 

Alternative iSCSI Implementation 

The preceding description detailed operation of the IT 10G using the host computer 
to assemble the iSCSI PDU header. An alternative embodiment allows the IT10G 
hardware and the on-chip processor to assemble and process the iSCSI PDUs. This 
alternative embodiment is described next. 

This section describes the hardware support for iSCSI using the on-chip processor. 
From a high level, the hardware offloads CRC and Fixed Interval Markers (FIMs) for 
transmitted packets. For the received data paths, the ability to DMA the PDU 
headers to either the on-chip processor or the host computer, and to DMA the data 
section of the PDU to the host is supported, along with CRC checking. This allows 
the iSCSI header and data to be separated and copied to the host computer 
memory, withpout requiring additional memory copies on the host computer. 



221 



WO 03/105011 



PCT/US03/18049 



Header Storage Unit (HSU) 

For iSCSI PDUs that are transmitted, the on-chip processor is responsible for 
5 building the headers for the packets in its memory. The on-chip processor will 
receive iSCSI Instruction blocks (IBs) from the host computer to indicate what sort of 
iSCSI PDU to generate. In the cases where there is SCSI data associated with a 
PDU, then a link-list of buffers is also provided via the IBs. 

1 0 Once the on-chip processor has generated the PDU header, it uses the HSU module 
to transfer the header from the on-chip processor memory to MTX memory (transmit 
data buffers). The HSU will also calculate the CRC for the header if necessary. 

If there is no SCSI data associated with the PDU, then as soon as the HSU module 
15 is enabled, it will begin transferring data from the on-chip processor memory to MTX 
memory. The CRC is also calculated and FIMs inserted if necessary. 

If there is SCSI data to be transferred in the PDU, two modes of DMA are provided; 
One-Shot and Link-List. If the Link List mode is used, then the HSU will retrieve the 

20 first link list (LL) entry and request a host DMA transfer. When the DMA engine 
indicates back the HSU that the first transfer is complete, the HSU will begin 
transferring the header from ARM memory to MTX memory. The data just DMA'ed 
is appended to the end of the header. Also during this time, the next LL entry is 
retrieved and a DMA is requested. Once the HSU has been granted a host DMA 

25 transfer, then it will be given locked access to the DMA engine (at least on the TX 
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side) till all entries in the LL have been serviced, 
logic easier to implement in the data paths. 
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This is to make the FIM and CRC 



CRC Calculation Module 

5 

This module is responsible for calculating the CRC value for both PDU headers as 
well as data sections. The CRC is then appended to the corresponding field. Data 
feeding this module can either come from the on-chip processor memory via the 
HSU (for header data), or from the DMA TX FIFO (for SCSI data). The output from 
1 0 the CRC calculator is fed to the FIM module. 

FIM Insertion Module 

This module is responsible for inserting FIMs into the PDU. It receives the initial 
15 offset, interval count, and PDU length from the HSU unit. When inserting the FIMs, 
some repacking of data will be necessary. Another function of this module is to 
determine the overall length of the PDU to be transmitted. This length is the 
programmed length of the PDU + any CRC bytes + any FIMs. This length is then 
passed to the XMTCTL module which is responsible for breaking the PDU into the 
20 appropriate size TCP packets. 

XMTCTL Mux Module 

This module is responsible for muxing data inputs to the XMTCTL module. Data can 
25 either be straight from the DMA TX FIFO buffer or from the FIM Insertion module. 
With either path, the mux logic indicates the total length of the packet as well as 
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provides the data in a 128 bit wide format, 
using a dav / grant handshake. 
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Data is passed to the XMTCTL module 



iSCSI Receive Support 

5 

Overview 

A block diagram of the iSCSI receive data path is depicted in the Figure 53. 
10 TCPRX Module 

This module 531 is responsible for parsing received TCP packets. When an iSCSI 
packet arrives, it is initially treated like any other TCP data in that it is stored in MRX 
memory in either 128 byte or 2K byte buffers. A bit in the socket's CB (the AS bit in 
15 WORD OxD, bit[30]) indicates whether this socket is owned by the host or by the on- 
chip processor. If the socket is owned by the on-chip processor, then the data are 
not automatically DMA'ed to the host. Instead, a status message is generated and 
sent to the on-chip processor via the normal network stack status message queue. 

20 On-Chip Processor Access to MRX Memory 

When the on-chip processor is notified that it has received iSCSI data on a socket, it 
can read the data in MRX via the CPU address and data registers in the mallocrx 
register set. It is expected that the on-chip processor is mainly reading the MRX 
25 memory 532 to determine the type of PDU received from the header in it. If the on- 
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chip processor decides to move the header to its memory it uses the LDMA module. 
If it decides to DMA and PDU data to the host, it uses the HDMA module 533, 



RXISCSI Module 

5 

When the on-chip processor wants to move data from MRX memory to its own local 
memory, it uses the RXISCSI module 534. The CRC for the data is optionally 
checked during this transfer. When the operation is complete, an interrupt or status 
message is generated. 

10 

If data spans multiple MRX buffers, then the transfer must be split into two requests. 
An example of this is shown in Figure 54. 

In this case, the first transfer should be programmed with Add 1 as the MRX source 

15 address and Length 1 as the transfer length. The LAST BLK bit should also not 

be set for the first transfer. When the operation is complete, a partial CRC result is 
also returned in the status message. The on-chip processor then programs the local 
DMA (LDMA) with Add 2 and Length 2 and the LAST. _BLK bit set to complete the 
header transfer. If the operations are back to back, then the CRC seed need not be 
20 programmed. Otherwise, the CRC partial result returned in the status message 
should be programmed as the CRC seed for the second transfer. In the case where 
only the CRC bytes remain in the second buffer, then a transfer of length 0 should be 
used with the CRC checking enabled. 

25 On-Cip Processor Initiated HDMAs 
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When the on-chip processor wants to send received SCSI data to the host, it 
programs the host DMA (HDMA) engine with the starting addresses in both MRX 
and host memories along with the length of the transfer. Alternatively, the on-chip 
processor can specify a location in its memory where a link list of buffers are located. 

5 

The link list can contain up to 255 entries. During the DMA transfer, the HDMA 
module can optionally be programmed to check the CRC value. If this option is 
enabled, then the DMA transfer length should not include the CRC bytes. Also, 
when CRC checking is requested, an optional CRC starting seed may be 
10 programmed. 

If the SCSI data is split across multiple MRX buffers, then the DMA transfer to the 
host must be split into separate requests. This situation is depicted in Figure 55. 

15 In this case, the HDMA should first be programmed with Add 1 as the starting MRX 
memory address and Length 1 as the transfer length. The Last_Host_Blk bit should 
also not be set for the first transfer. When the DMA operation is complete a status 
message is generated. If CRC checking was also requested, then the status 
message also returns the partial checksum value. The on-chip processor then 

20 programs the HDMA engine with Add 2 and Length 2 and set the Last_Host_Blk bit 
to complete the data transfer. If these two transfers are back-to-back, then the CRC 
seed value need not be programmed. Otherwise, the partial CRC result returned in 
the status message is programmed as part of the second DMA transfer request. In 
the case where only the CRC bytes remain in the second buffer then a transfer of 

25 length = 0 and CRC_En = 1 should be used. 
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For on-chip processor owned sockets, the on-chip processor is responsible for 
releasing MRX buffers that are no longer in use back to the MRX buffer de-allocator. 
5 It does this by writing the base address for the block to be released into either the 
MRX_128_Block_Add or MRX_2K_Block_Add registers and then issuing the release 
command to the corresponding MRX_Block_Command register. 

IPSec Support Architecture 

10 

Overview 

The following discussion details the support that is implemented in hardware for 
IPSEC. This implementation assumes a separate module to handle the 
15 computational aspects of encryption, decryption, and authentication functions of the 
protocol, all of which are well-known and understood. The implementation also 
assumes that any key exchange protocols, which are well-known and well 
understood, used, such as IKE, are handled as applications on the host computer. It 
is, of course possible to also integrate the key exchange functions. 

20 

This discussion breaks down the IPSEC support into transmit and receive sections. 
This is done because outside of sharing a common security association (SA) Block, 
the two modules operate independently of one another. 

25 IPSec Features: 
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• Anti-replay support on a per-SA basis 

• Null, DES, and 3DES algorithms, and AES 128-bit algorithm in cipher-block 
chaining (CBC) mode 

• Null, SHA-1 and MD-5 authentication algorithms 

• Variable-length encryption keys up to 1 92 bits 

• Variable-length authentication keys up to 1 60 bits 

• Jumbo frame support 

• Automatic handling of SA expiration on the basis of both time and total data 
transferred 

• IPsec Policy Enforcement 

• IPsec exception handling, including exception-packet generation, and status 
reporting 

IPSec Protocols and Modes: 

• Transport AH 

• Transport ESP 

• Transport ESP + AH 

• Tunnel AH 

• Tunnel ESP 

• Tunnel ESP + AH 

• Transport AH + Tunnel AH 

• Transport AH + Tunnel ESP 

• Transport AH + Tunnel ESP + AH 

• Transport ESP + Tunnel AH 

• Transport ESP + Tunnel ESP 



228 



WO 03/105011 PCT/US03/18049 

• Transport ESP + Tunnel ESP + AH 

• Transport ESP + AH + Tunnel AH 

• Transport ESP + AH + Tunnel ESP 

• Transport ESP + AH + Tunnel ESP + AH 

5 

Security Association Block Format (SA) 

A dedicated memory structure is used to store information on each IPSEC 
connection. There are separate blocks for AH and ESP protocols and for both RX 

10 and TX SA's (RX SA's cover data received by and TX SA's cover data transmitted). 
Therefore, a socket connection that uses both AH and ESP for both sending and 
receiving data requires multiple SA blocks. AH requires 1 SA Block, and ESP 
requires two blocks (ESP-1 and ESP-2). The total number of socket connections 
that may be secured is dependent upon the total amount of memory provided for the 

15 SA blocks. 

Tx data path can support Tunnel and Transport mode in single pass. In worst-case 
scenario, six SA Blocks can be linked together if both AH and ESP are used in both 
tunnel and transport modes. For transmitted data, the socket CB contains a pointer 
20 to either the Tunnel/Transport TX AH or Tunnel/Transport TX ESP-1 SA. In cases 
where both protocols are used for transmitted data, the CB contains a link to the TX 
AH SA, which in turn contains a link to the TX ESP-1 SA. 

Rx data path does not support AH and ESP decryption in single pass. Rx data path 
25 does not support Tunnel and Transport modes in single pass. Encrypted packet is 
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SA_LUT contains a pointer to either 



Figure 56 shows SA Block Flow. 

5 

A Creation for Client Sockets 

When an application needs to create an IPSEC protected client socket, it should 
perform the following sequence. 

10 

• Write all the applicable SA parameters to the IPSEC SA specific registers. 
This may need issuing of multiple write commands. SA handle is inserted into 
the RX SA LUT. 

• IPSEC returns the new SA handle 

15 • Write this SA handle in Socket specific register 

• Write all the applicable socket parameters to the TCP socket specific 
registers, including setting of the IPSEC bit in the Socket Configuration 2 
register 

• Issue the commit_socket command 

20 

A link to the TX SA is stored in the Open CB. The socket is now ready for use. 

SA Creation for Server Sockets 

25 When an application needs to create an IPSEC protected server socket, it should 
perform the following sequence. 

230 



WO 03/105011 



PCT/US03/18049 



• Write all the applicable SA parameters to the IPSEC SA specific registers. 
This may need issuing of multiple write commands. SA handle is inserted into 
the RX SA LUT 

• IPSEC returns the new SA handle 

• Write this SA handle in Socket specific register 

• Write all the applicable socket parameters to the TCP socket specific 
registers, including setting of the IPSEC bit in the Socket Configuration 2 
register 

• Issue the commit_socket command 

The commit socket command, in addition to creating the Server Port Information 
table entry, also creates a HO CB. The HO CB has the IPSEC bit set in it. This bit 
prevents the HO CB from being reused by another incoming SYN that happens to 
decode to the same HASH. TX SA Handle is stored in the HO CB. The socket is now 
ready for use. 

Note: In this case, as mentioned above, the HO CB does not get overwritten when a 
SYN with the same HASH is received. The HO CB is deprecated when the socket 
transitions to the Established state and an Open CB is created. However, in the 
case where a socket fails to reach the established state, it is the responsibility of the 
Host to manually deprecate the HO CB. It does this by entering the HO CB handle 
into the HO_CB_Handle register, and then issuing the DeprecateJHOCB command. 
The host in this situation should deprecate the associated SA blocks. 

SA Linking 
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SA Block has Link Valid bit and Link field, which point to another SA. CPU can use 
this field to link multiple SA, if needed. CPU should perform following sequence to 
Link SA Blocks: 

5 

• Configure SAJJnk register with SA Block to be linked 

• Set Link_Val bit in CFG1 register 

• Configure SA_Handle register with SA Block getting linked. 

• Issue "Update SA" command. 

10 

SA Deprecation/De-allocation 

Tx or Rx SA blocks are not deprecated automatically, when CBs are deprecated. 
CPU has to keep track of which SA Blocks are not in use and issue "Invalidate SA" 
1 5 command to deprecate/de-allocate those SA blocks. 

When SA is expired, HW generates interrupt, if not masked. Expired SA Blocks are 
not de-allocated from the memory. This event also generates the status message, 
which contains SA handle of the expired SA. CPU can use this handle to update this 
20 SA or CPU can issue an "Invalidate SA" command to deprecate/de-allocate that SA 
Block. 

TX AH Transport SA Block Format 
25 Figure 57 shows TX AH Transport SA Block Format. 
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TX ESP- 1 Transport SA Block Format 
Figure 58 shows TX ESP-1 Transport SA Block Format. 
5 TX ESP- 2 Transport SA Block Format 

Figure 59 shows TX ESP-2 Transport SA Block Format. 
TX AH Tunnel SA Block Format 

10 

Figure 60 shows TX AH Tunnel SA Block Format. 
TX ESP- 1 Tunnel SA Block Format 
1 5 Figure 61 shows TX AH Tunnel SA Block Format. 
TX ESP- 2 Tunnel SA Block Format 
Figure 62 shows TX ESP-2 Tunnel SA Block Format. 

20 

RX AH SA Block Format 
Figure 63 shows RX AH SA Block Format. 
25 RX ESP- 1 SA Block Format 
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RX ESP- 2 SA Block Format 
5 Figure 65 shows RX ESP-2 SA Block Format. 
Security Association Block Field Definitions 
SA Type 

10 

These bits are used to specify the type of SA Block the block represents, and are 
provided for diagnostic support. The decoding is shown in the following table. 



Table 26 SA Type Decodes 



SA Type 


Description 


00000 


Reserved 


00001 


TX AH Tunnel 


00010 


TX ESP-1 Tunnel 


00011 


TX ESP-2 Tunnel 


00100 


TX AH Transport 


00101 


TX ESP-1 Transport 


00110 


TX ESP-2 Transport 


01001 


RX AH 


01010 


RX ESP-1 


01011 


RX ESP-2 



15 
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All other decodes not shown in the above table are reserved for future use. 
SA Version 

5 These bits specify the version number of the SA and are provided for diagnostic 
purposes. The current version for all SA Block types is 0x1 . 

XV, RV (Transmit / Receive SA Valid) 

1 0 These bits indicate that the SA Block is valid and can be used. 

XA, RA (Transmit / Receive Authentication Enable) 

These bits indicate that authentication is enabled for this protocol and should be 
15 used for packets on this socket. The corresponding Authentication algorithm and 
key fields are also valid. For TX/RX AH SA's, this bit should always be set. For 
TX/RX ESP SA's, it is optional. 

XA_ALG, RA_ALG (Transmit / Receive Authentication Algorithm) 

20 

These bits indicate the algorithm to be used for authentication. The possible choices 
are listed in the following table. 



Table 27 Authentication Algorithm Selections 



XA.ALG / 




RA_ALG 


Authentication Algorithm 
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000 


Null Authentication 


001 


MD5 


010 


SHA-1 



All decodes not shown are reserved for future use. 
XE, RE (Transmit / Receive Encryption Enable) 

5 

These bits indicate that encryption should be used for packets on this socket, and 
indicates that the Encryption key and Encryption Algorithm fields are valid. This bit is 
only defined for TX/RX ESP SA's. 

1 0 XE_ALG, RE_ALG (Transmit / Receive Algorithm) 

These bits indicate the algorithm to be used for encryption. The possible choices are 
listed in the following table. 



Table 28 


Encryption Algorithm Selections 


XE_ALG 


Encryption Algorithm 


000 


Null Encryption 


001 


DES 


010 


3DES 


011 


AES-128 in CBC Mode 



All other decodes not shown are reserved for future use. 
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This bit indicated that Anti-Replay algorithm should be used for received packets. 
5 XTV, RTV (Transmit / Receive Timestamp Valid) 

These bits indicate that the timestamp field is valid in the SA, and that when the 
timestamp expires, the SA Block should be considered stale. 

1 0 XBV, RBV (Transmit / Receive Byte Count Valid) 

These bits indicate that the byte count limit field is valid in the SA, and that when the 
byte count reaches this value that the SA Block should be considered stale. 

15 XSV, RSV (Transmit / Receive Sequence Limit Valid) 

These bits indicate that when the sequence number field wraps past OxFFFFFFFF 
that the SA Block should be considered stale. 

20 Note: If none of the xTV, xBV or xSV bits is set, then the SA Block is deemed 
perpetual, and never expires. 

RDC (Receive Destination IP Check Enable) 

25 This bit indicated that the Destination IP address of any packet must match this SA's 
Destination IP Address field. 
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RSC (Receive SPI Check Enable) 

This bit indicated that the SPI field of an IPSEC header being processed must match 
5 this SA's Destination IP Address field. 

RTR (Receive Timestamp Watermark Limit Reached/Disabled) 

If this bit is not set then timestamp watermark checking could be performed. When it 
10 causes a status message, this bit is set, so that further watermark status messages 
are not sent. 

LV (Link Valid) 

15 This bit indicates that a SA Block is linked to this SA. When this bit is valid Link field 
contains SA handle for the next SA Block. 

SPI Number 

20 This is the SPI associated with the protocol. For TX SA's this SPI is included in the 
protocol header. For RX SA's this SPI is compared against the corresponding fields 
in the received data packets. 

Sequence Number 

25 

238 



WO 03/105011 PCT/US03/18049 

This is the sequence number associated with the protocol. Because AH and ESP 
SA's may expire at different times, the Sequence number may be different between 
the two protocols. For TX SA's, this sequence number is reset to 0x00000000 when 
the SA is created and incremented by one for each packet that is transmitted using 
5 the SA Block. For received packets, this field represents the last Sequence number 
received on the socket, and is used to check for packet replays. 

Authorization Key 

10 This parameter is the key used for the authentication for the protocol. If the key is 
less then 160 bits, it is Isb justified. 

Encryption Key 

15 This parameter is the key used for the encryption of IPSEC packets, and is only 
defined for TX/RX ESP SA's. For algorithms that use less then 1 92 bits, the key 
should be Isb justified. 

Timestamp 

20 

This is the timestamp in the future of when the SA Block is considered stale. It is 
initialized when the SA is created. When a packet is sent out or received, the current 
free running millisecond timestamp is compared to this time. If the time matches or 
is greater then this timestamp, then the SA Block is considered stale. 

25 

Byte Count 



239 



WO 03/105011 



PCT/US03/18049 



This parameter is set when the SA is initialized. It determines the maximum number 
of bytes that may be sent out using the SA Block. HW uses this as an initial number 
for a decrementing counter. HW decrements this byte count as packets are 
5 transmitted or received for this SA. When byte count reaches zero, SA is considered 
stale. The xBV bit should be set if this limit is to be used. 

Link 

10 This field points to the next SA Block associated with the socket. 
IPSEC Module 

IPSEC is divided into following four major modules. 
15 • IPSECX 

• IPSECR 

• IPSECREGS 

• IPSEC Memories 

20 IPSECX contains transmit data path logic the IPSEC. Data and control packets are 
transferred first into internal IPSECX memory. Encryption Engine reads these 
packets, encrypts them and writes back these packets into IPSECX memory. These 
packets are then forwarded to Ethernet transmitter for transmission. 

25 IPSECR contains receive data path logic the IPSEC. Any incoming packet is parsed 
for IPSEC type packet. If packet is an IPSEC packet, then it is transferred to internal 
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IPSECR memory. Decryption Engine decrypts this packet and writes back this 
packet to IPSECR memory. This packet is read and injected back to the network 
stack. This time this packet is decrypted, so parser does not identify as an IPSEC 
packet, but it is identified as normal TCP/IP packet. 

5 

IPSECREGS contains programmable registers for CPU. By programming these 
registers, CPU can create, update or delete a SA. This module provides indirect 
memory accesses to internal memories for diagnostic purposes. 

10 IPSEC uses two SRAMs as depicted into following diagram. Both memories can hold 
packet of 9KB size. IPSEC Memory sizes are as follows: 

• IPSECX Memory: 592 X 32bits X 4 Dual Port (9472 Bytes) 

• IPSECR Memory: 1 1 68 X 32bits X 2 Dual Port (9344 Bytes) 

15 

Figure 66 is a block diagram that depicts the overall flow for the IPSEC logic. 
IPSEC Tansmit Data Paths (IPSECX) 
20 Overview 

The following discussion details the transmit IPSEC data path. The IPSEC 
encryption / authentication engine operates on packets that have been preformed 
prior to the engine being called. A block diagram outlining the data flow is depicted 
25 in Figure 67. 
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TXDATCB/TCPACK 

The transmit data for an IPSEC protected socket is first stored in the MTX DRAM 
671 in the same manner as normal sockets. The TXDATCB/TCPACK module 672 is 
then responsible for forming the Ethernet, IP, TCP, and any IPSEC headers for the 
packet. This module reads information from the appropriate SA Block to determine 
which headers and what the format of the headers needs to be. Each socket has a 
CB structure associated with it. The CB contains state information on each socket. 
Within the CB structure, there are pointers of SA Blocks to be used. For sockets that 
needs multiple SA Blocks, that CB contains pointers to all AH and ESP1 SA Blocks. 

The TXDATCB/TCPACK module writes the packet's header into a buffer in MTX 
DRAM. If it sees that the packet requires IPSEC processing then it signals to the 
IPSECXIF module 673 that there is a packet ready for processing. If at the 
beginning of the header generation process, the TXDATCB/TCPACK module notices 
that the IPSECXIF block is full, then it places the packet back in the transmission 
queue to be processed later. 

TCPACK 

Besides data packets, TCP utility packets (ACKs, SYNs, FINs) can also be 
encrypted. These packets come from the TCPACK module. Although not shown in 
the above data path in Figure 67, this module also accessed the CB and SA 
memories. 
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Note: RST packets that are generated due to no local socket being available are 
never IPSEC protected. The only RST packets that may be protected are those 
used for abortive closes or in response to an illegal SYN/ACK received in response 
to a SYN. Both of these RST packets are formed by the TCPACK module and not 
the regular RST packet queue. 

IPSECXIF 

This module is responsible for transferring the packet from MTX DRAM (via 
TCPDATCB) or TCPACK and into the IPSECX internal memory. This internal 
memory is organized as 576 x 128 bits. Upon getting a packet from TXDATCB or 
TCPACK, this module begins transferring the data to the IPSEC memory. It also 
gets the applicable information for the SA from SA registers to pass it to the 
Encryption engine. A Read pointer is fed back from IPSECTX to prevent this module 
from over-writing current packets within the IPSECX memory. 

ENCRYPTION / AUTHENTICATION ENGINE 

This module 674 is responsible for encrypting and adding authentication to the 
packet. It takes the parameters provided by the IPSECXIF module, and processes 
the packet stored in the IPSECX memory 675. If both authentication and encryption 
is needed on a packet, it is assumed that this module is before both features before 
passing the packet to the IPSECTX module. The encrypted data should be written 
to the same memory location as the source packet. When the processing is done, it 
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signals to the IPSECTX module that a completed packet is ready for transmission. 
The encryption engine runs entirely in the dram_clk domain. 



This module may be comprised of two parallel and identical encryption engines. In 
5 that case, they are serviced in alternating order. Also, when the encrypt_rdy 
indicator is sent to IPSECTX, the packet presented should be in the same order as 
they were presented to the encryption engine. 

IPSECTX 

10 

This module 676 is responsible for taking the processed packet from the encryption 
engine and scheduling it for transmission. When it gets a ready indication from the 
encryption engine, it registers the starting address and packet length information. It 
then sends a transmission request to the Ethernet transmission arbitrator. The 
15 Ethernet transmission arbitrator reads the packet data directly from IPSECX memory 
and sends it to the MAC's transmit buffer. When the entire packet has been read 
out, it strobes ipsectx_done. Upon receiving this indication, the IPSECTX module 
updates its ipsectx_rd_add. This bus is passed back to IPSECXIF to indicate that 
more memory has been freed. 

20 

IPSECX Memory Arbitrator (IPSECX MEMARB) 

This module 697 is responsible for arbitrating accesses to the IPSECX memory 
bank. This module runs in the dram_clk domain. 

25 

IPSECX Memory Interface (IPSECX MEMIF) 
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This module 678 provides interface to dual port RAM. This module is glue between 
SRAM and other logic accessing the RAM. This module may need to change if RAM 
model is changed. This module operates entirely on dram_clk domain 

5 

IPSEC Receive Data Paths (IPSECR) 
Overview 

10 The block diagram in Figure 68 depicts the data path flow for received IPSEC 
packets. It forms the basis for the discussions that follow. 

Data Flow for IPSEC Received Packets 

15 IPIN 

The received data for an IPSEC protected socket is first parsed in the IPIN module 
687. Within the outermost IP header is the protocol field that indicates the protocol 
type of the next header. If it detects that the protocol is 0x50 (ESP) or 0x51 (AH), it 
20 then completes packet including outermost IP header to the IPSECRIF module. 

If the received packet is fragmented, then it is treated like any other fragmented IP 
packet, and sent to the exception processor. When the packet is complete, it is 
injected back into the bottom of the IP stack via the IPINARB module 682. 
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IPSECRIF 

When IPIN indicates to this module 683 that an IPSEC packet has been received, it 
starts to store the packet into IPSECR memory 684. The packet is stored starting 
5 with the header immediately following the outermost IP header. The IPSECRIF 
module also parses the SPI, source IP address, and AH/ESP setting to perform a 
LUT lookup to find the correct RX SA Block. When it gets the LUT value, it reads the 
SA Block to see if its parameters match the received packet's parameters. If they do 
match, then we have the appropriate SA. If it does not then, then the packet is 
10 dropped and the event logged. 

When the correct SA Block is found, the receive SA parameters are read and stored. 
The sequence number(s) is checked to see if it is valid, if the anti-replay feature is 
enabled for this SA. If it is good, then the SA parameters, along with the starting 

15 memory address in IPSECR memory for the packet, are passed to the Decryption 
module 685. If the sequence number is invalid, then the packet is dropped and the 
event logged. Sequence numbers and Sequence bitmaps are not updated at this 
time however. The purpose of doing the anti-reply check at this point is to prevent a 
bad packet from being needlessly decrypted and authenticated. The anti-reply 

20 updating is handled in the IPSECRX module 686 after the packet has been 
authenticated. 

DECRYPTION / AUTHENTICATION 

25 This module 685 is responsible for decrypting and authenticating the IPSEC packet. 
When a packet is available, the IPSECRIF module indicates this to the decryption 
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engine by asserting the ipsecrif_rdy signal. The IPSECRIF module also provides the 
starting address for the packet. If the packet fails authentication, then it is discarded 
and the event is logged. If the authentication passes, then the packet is decrypted, if 
required. The decrypted packet is written back to the same IPSECR memory 
5 location as the original packet. The Decryption engine then indicates that a packet is 
ready to be received to the IPSECRX module by asserting decrypt_rdy. If a packet 
requires both authentication and decryption, it is assumed that both functions are 
complete prior to handing the packet off to the IPSECRX module. 

10 This module may be comprised of two parallel and identical decryption engines. In 
that case, they are serviced in alternating order. Also, when the decrypt_rdy 
indicator is sent to IPSECRX, the packet presented should be in the same order as 
they were presented to the decryption engine. 

15 Note: The Decryption / Authentication engine runs off of the DRAM clock. 

IPSECRX 

This module 686 is responsible for taking the decrypted/authenticated packet and 
20 injecting it back into the stack. For tunnel mode packets, the processed packet can 
be injected directly back via IPINARB. For transport mode packets, an IP header is 
created and pre-pended to the start of the packet. Doing this allows us to re-use the 
TCP checksum and interface logic inside of IPIN for all packets. 

25 This module is also responsible for updating the receive SA Block for the packet. 
The new sequence number and bitmap for the SA, along with the SA handle is 
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passed to this module from the Decryption engine. This module updates the 
timestamp and bytes count received. If it finds that any of the parameters have 
reached with their limits, then the SA is invalidated and a status message is sent to 
the exception processor. 

5 

IPSECR Memory Arbitrator (IPSECRMEMARB) 

This module 687 is responsible for arbitrating accesses to the IPSECR memory 
bank. This module runs in the dram_clk domain. 

10 

IPSECR Memory Interface (IPSECR MEMIF) 

This module provides interface to dual port RAM. This module is glue between 
SRAM and other logic accessing the RAM. This module may need to change if RAM 
1 5 model is changed. This module operates entirely on dram_clk domain 

IPSEC LUT 

This LUT is organized as 128K by 17 bits. Each word is made up of a 16 bit SA 
20 handle and a 1 bit valid indicator. Physically, the LUT is contained within the MTX 
DRAM bank. 

IPARB 

25 This module arbitrates the traffic coming from Ethernet Input Parser and IPSECRX. 
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This is the algorithm to be used to check for anti reply checking. This algorithm uses 
a 32-bit window to check for the last 32 sequence numbers. The msb of the bit map 
5 represents the oldest sequence number, and the Isb represents the current 
sequence number. This algorithm is used for both AH and ESP protocols. 

LAST_SEQ: Last received sequence number. This is stored in the SA Block 
SEQ: Sequence number of received packet. 
10 BITMAP: 32-bit bitmap representing the last 32 sequential sequence numbers. 

Figure 69 is a flow diagram that shows the IPSEC Anti-Replay Algorithm. 

IPSEC Registers (IPSECREGS) 

15 

Overview 

This module provides interface to CPU and contains programmable registers. This 
module also creates, updates or invalidates the SA when CPU issues proper 
20 command. It provides indirect access to following memories for diagnostic purposes. 

. IPSECX 
. IPSECR 
. RXSALUT 
25 • SA Block 
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For both receive and transmit SA blocks, a status message is generated to the on- 
chip processor whenever an Block becomes invalid. Blocks may become invalid due 
5 to the sequence number reaching OxFFFF, or the timestamp or byte count reaching 
their limits. 

SA Block to DRAM Interface and Data Flow 
1 0 Overview 

The following discussion overviews the interface for SA Block accesses via the NS 
DDR Arbitration module. It depicts the data flow, lists interface signals, and details 
the timing required. 

15 

Data Flow 

Three different access types are supported for SA Blocks These are burst writes, 
burst reads, and single reads. The ipsecsarb module arbitrate requests from 
20 different sources for access to the SA memory. 

SA LUT 
Overview 

25 
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The IPSEC receive logic uses a LUT to find the proper SA Block. The LUT is 32K 
deep by 16 bits. Each LUT Block contains the SA Block handle. If SA handle has 
value 0, it's considered invalid. 

SA LUT to DRAM Interface 

The following discussion overviews the interface between the SA LUT and the Data 
DDR Arbitration module. It depicts the data flow, lists interface signals, and details 
the timing required. 

Data Flow 

The SA LUT only does single read and write accesses to the DRAM. The accesses 
are always in WORDs. Because each LUT Block is only 16 bits, only the bottom 16 
bits of the WORD are passed to the SA LUT memory interface. Reads and writes 
never occur in the same LUT access cycle. 

Although the invention is described herein with reference to the preferred 
embodiment, one skilled in the art will readily appreciate that other applications may 
be substituted for those set forth herein without departing from the spirit and scope of 
the present invention. Accordingly, the invention should only be limited by the 
Claims included below. 
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Claims 

1 . An integrated network adapter for decoding and encoding network protocols 
and processing data, comprising: 

a hardwired data path for processing streaming data; 

a hardwired data path for receiving and transmitting packets and for encoding 
and decoding packets; 

a plurality of parallel, hardwired protocol state machines; 

wherein each protocol state machine is optimized for a specific network 
protocol; and 

wherein said protocol state machines execute in parallel; and 
means for scheduling shared resources based on traffic. 

2. An integrated network adapter embodied in a single integrated circuit, said 
network adapter comprising: 

a hardwired transport offload engine (TOE); 
a processor integrated with said TOE; 
a physical layer module (PHY); 
a media-access layer module (MAC); 
an IPsec processing engine integrated with said TOE; and 
an upper-level protocol (ULP) for offload processing, said ULP integrated with 
said TOE. 

3. The network adapter of Claim 2, wherein said ULP implements an iSCSI 
protocol. 
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4. An integrated network adapter, comprising: 

a hardwired data path for receiving and transmitting packets and for encoding 
and decoding packets; 
5 at least one hardwired protocol state machine; and 

at least one communication channel between said network adapter and a host 
computer. 

5. The network adapter of Claim 4, wherein said at least one communication 
1 0 channel employs instruction blocks (IBs) and status messages (SMs) to transfer data 

and control information. 

6. The network adapter of Claim 4, further comprising: 

at least one threshold timer for controlling communication via said at least one 
15 communication channel; 

wherein data are transferred at selected threshold interval. 

7. The network adapter of Claim 4, further comprising: 

a module for establishing at least one data threshold for controlling 
20 communication via said at least one communication channel; 

wherein data are transferred when data levels reach a selected threshold. 

8. The network adapter of Claim 6, wherein said timer threshold comprises an 
interrupt aggregation mechanism for reducing a number of interrupts between said 

25 network adapter and said host computer and for increasing data throughput. 
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9. The network adapter of Claim 4, further comprising: 
a hardwired transport offload engine (TOE); 

a processor integrated with said TOE; and 

an interrupt aggregation mechanism for optimizing data throughput of said 
5 processor and TOE. 

1 0. The network adapter of Claim 4, further comprising: 

a module that provides optimized hardware support for TCP Selective 
Acknowledgement (SACK); 
10 wherein TCP acknowledges missing data packets and retransmits said missing 

data packets, but only said missing data packets. 

1 1 . The network adapter of Claim 4, further comprising: 

a module that provides optimized hardware support for TCP slow start. 

15 

12. The network adapter of Claim 11, wherein slow start slowly ramps up a 
number of data segments in flight at one time by: 

initially only allowing two data segments that correspond to a current window, 
cwnd, of twice a maximum segment size (MSS) fly before expecting an 
20 acknowledgement (ACK); and 

increasing cwnd by one MSS for each successful ACK received, to allow one 
more segment in flight, until cwnd is equivalent to a receiver's advertised window. 

13. The network adapter of Claim 11, wherein slow start is always started on a 
25 new data connection; and wherein slow start may be activated in the middle of a 

connection when a data traffic congestion event occurs. 
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1 4. The network adapter of Claim 4, further comprising: 

a module that provides optimized hardware support for TCP fast retransmit. 

15. The network adapter of Claim 14, wherein fast retransmit immediately 
generates an ACK when an out of order segment is received to allow a sender to fill a 
hole quickly, instead of waiting for a standard time out. 

1 6. The network adapter of Claim 1 4: 

wherein fast retransmit is invoked when a receiver receives three duplicate 

ACKS; 

wherein a sender tries to fill a hole when fast retransmit is invoked; and 
wherein a duplicate ACK is considered duplicate when ACK and window 
advertisement values in a segment match one another. 



1 7. The network adapter of Claim 4, further comprising: 

a module that provides optimized hardware support for TCP window scaling. 

18. The network adapter of claim 17, wherein a window scaling operation is based 
on three variables, which comprise: 

a least one bit for enabling window scale; 
at least one bit for setting a scaling factor; and 
a parameter for determining a scaling value. 



1 9. The network adapter of Claim 4, further comprising: 
a hardwired transport offload engine (TOE); 
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a processor integrated with said TOE; and ' 

a module that provides optimized hardware support for iSCSI header and data 
CRC generation and checking. 

20. The network adapter of Claim 4, further comprising: 
a hardwired transport offload engine (TOE); 
a processor integrated with said TOE; and 

a module that provides optimized hardware support for iSCSI fixed-interval 
marker (FIM) generation. 



21 . The network adapter of Claim 4, further comprising: 
a hardwired transport offload engine (TOE); 

a processor integrated with said TOE; and 

a module that provides optimized hardware support for TCP dump mode, 
15 wherein TCP dump mode supports diagnostic programs and packet monitoring 
programs. 

22. The network adapter of Claim 21 , wherein when TCP dump mode is enabled 
all received packets are sent to said host as exceptions and all outgoing TCP/UDP 

20 packets coming from a hardware stack are looped back as exception packets. 

23. The network adapter of Claim 22, further comprising: 

a driver copying said exception packets for a network monitor, and for re-injecting 
rx packets and sending TX packets as raw Ethernet frames. 



24. The network adapter of Claim 4, further comprising: 
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a hardwired transport offload engine (TOE); 
a processor integrated with said TOE; and 

a module that provides optimized hardware support for host ACK mode; 

wherein a TCP ACK is only sent when said host has received data from a 
TCP segment to provide data integrity where data may be corrupted as they are 
passed between said host computer and said network adapter. 

25. The network adapter of Claim 24, wherein host ACK mode waits for a DMA of 
an MTX buffer that contains a data segment to complete before sending an ACK. 

26. The network adapter of Claim 4, further comprising: 

a hardwired transport offload engine (TOE); 
a processor integrated with said TOE; and 

a module that provides optimized hardware support for TCP timestamps to allow 
TCP to calculate a Round Trip Time Measurement (RTTM) better, and to support Protect 
Against Wrapped Sequences (PAWS). 

27. The network adapter of Claim 4, further comprising: 

a hardwired transport offload engine (TOE); 
a processor integrated with said TOE; and 

a module that provides optimized hardware support for TCP PAWS to protect 
against old duplicate segments corrupting TCP connections. 

28. The network adapter of Claim 4, further comprising: 

a hardwired transport offload engine (TOE); 
a processor integrated with said TOE; and 
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a module that provides optimized hardware support for TCP host retransmit 
mode to allow retransmission of data directly out of a host's memory buffers, instead of 
out of buffers located in said network adapter. 

5 29. The network adapter of Claim 4, further comprising: 
a hardwired transport offload engine (TOE); 
a processor integrated with said TOE; and 

a module that provides optimized hardware support for random initial sequence 
numbers. 

10 

30. The network adapter of Claim 4, further comprising: 
a hardwired transport offload engine (TOE); 
a processor integrated with said TOE; 

a module that provides optimized hardware support for dual stack mode; and 
15 a hardware TCP/IP stack integrated into said network adapter that works in 

cooperation and in conjunction with a software TCP/IP stack in said host; 

wherein said network adapter supports co-existence of said software TCP/IP 
stack running in parallel using a same IP address as said network adapter. 

20 31 . The network adapter of Claim 30, further comprising: 

a module for supporting SYN status message mode; 
wherein any received SYN generates a status message back to said host; 
wherein SYN/ACK is not generated by said network adapter until said host 
sends a proper instruction block back to said network adapter; and 
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wherein if said SYN status message mode is not enabled on said network 
adapter, then SYN/ACKs are generated automatically by said network adapter, and 
SYN received status messages are not generated. 

5 32. The network adapter of Claim 30, further comprising: 

a module for supporting suppression of RST messages from said network 
adapter when a TCP packet is received that does not match a network adapter control 
block database; 

wherein, instead of automatically generating a RST, said network adapter 
10 hardware sends a packet to said host as an exception packet to allow said software 
TCP/IP stack in said host to handle said packet as an exception packet. 

33. The network adapter of Claim 4, further comprising: 

a hardwired transport offload engine (TOE); 
1 5 a processor integrated with said TOE; and 

a module that provides optimized hardware support for IP ID splitting to allow 
said host and said network adapter to share an IP address without overlapping IP ID's. 

34. The network adapter of Claim 4, further comprising: 
20 a hardwired transport offload engine (TOE); 

a processor integrated with said TOE; and 

a module that provides optimized hardware support for filtering of data packets 
to restrict, accept, or take special action on certain types of packets. 

25 35. The network adapter of Claim 34, wherein said filtering can take any of the following 
attributes: 
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accept a programmed uni-cast address; 
accept broadcast packets; 
accept multicast packets; 

accept addresses within a range specified by a netmask; and 
allow a promiscuous mode that accepts all packets. 

36. The network adapter of Claim 4, further comprising: 

a hardwired transport offload engine (TOE); 
a processor integrated with said TOE; and 

a module that provides optimized hardware support for virtual local area network 
(VLAN). 

37. The network adapter of Claim 36, wherein said VLAN module comprises any of: 

an element for stripping incoming packets of their VLAN headers; 
an element for generating VLAN tagged outbound packets; 
an element for generating VLAN parameters from incoming SYN frames; and 
an element for passing VLAN tag information for exception packets and UDP 
packets. 

38. The network adapter of Claim 4, further comprising: 

a hardwired transport offload engine (TOE); 
a processor integrated with said TOE; and 

a module that provides optimized hardware support for jumbo frames. 

39. The network adapter of Claim 4, further comprising: 

a hardwired transport offload engine (TOE); 
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a processor integrated with said TOE; and 

a module that provides optimized hardware support for Simple Network 
Management Protocol (SNMP). 

5 40. The network adapter of Claim 4, further comprising: 
a hardwired transport offload engine (TOE); 
a processor integrated with said TOE; and 

a module that provides optimized hardware support for management 
information base (MIB). 

10 

41 . The network adapter of Claim 4, further comprising: 

a hardwired transport offload engine (TOE); 
a processor integrated with said TOE; and 

a module that provides optimized hardware support for flexible and 
1 5 programmable memory error checking and correction (ECC). 

42. The network adapter of Claim 41 : 

wherein said ECC module uses at least one extra bit to store an encrypted 
ECC code with data in a packet; 
20 wherein when said data are written to memory, said ECC code is also stored; 

wherein when said data are read back, said stored ECC code is compared to 
an ECC code which would have been generated when said data were written; 

wherein if said ECC codes do not match, a determination is made as to which 
bit in said data is in error; 
25 wherein said bit in error is flipped and a memory controller releases said 

corrected data; 
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wherein errors are corrected on-the-fly, and corrected data are not placed 
back in said memory; and 

wherein if same corrupt data are read again, operation of said ECC module is 
repeated. 

5 

43. The network adapter of Claim 4, further comprising: 
a hardwired transport offload engine (TOE); 
a processor integrated with said TOE; and 

a module that provides optimized hardware support for network adapter 
1 0 operation in legacy modes; 

wherein all network traffic are sent to said host regardless of traffic type; and 
wherein said network adapter operate as if a hardware TCP/IP stack were not 
present therein. 



15 44. The network adapter of Claim 4, further comprising: 
a hardwired transport offload engine (TOE); 
a processor integrated with said TOE; and 

a module that provides optimized hardware support that allows IP 
fragmentation to be handled in either of hardware and software; 
20 wherein IP fragmented packets that are passed up as exception packets and 

reassembled in a software driver are re-injected via an IP injection mode back into 
said network adapter. 



45. The network adapter of Claim 4, further comprising: 
25 a hardwired transport offload engine (TOE); 

a processor integrated with said TOE; and 
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a module that provides optimized hardware support for IP injection that allows IP 
packets to be injected into a TCP/IP stack in said network adapter. 



46. The network adapter of Claim 45, said IP injection module further comprising: 

5 

one or more injection control registers for injecting an IP packet into said 
network adapter TCP/IP stack; 

wherein said one or more injection control registers allow said host to inject an 
IP packet into said network adapter TCP/IP stack. 

10 

47. The network adapter of Claim 4, further comprising: 

a hardwired transport offload engine (TOE); 
a processor integrated with said TOE; and 

a module that provides optimized hardware support for any of Network Address 
15 Translation (NAT), IP masquerading, and port forwarding via port range registers 
that forward all packets of a specified type UDP or TCP that fall in a programmable 
range of ports to an exception path; 

wherein said port registers enable certain ranges of ports to be used for 
network control operations and port forwarding. 

20 

48. The network adapter of Claim 4, further comprising: 

a hardwired transport offload engine (TOE); 
a processor integrated with said TOE; and 

a module that provides optimized hardware support for multiple IP addresses. 

25 

49. The network adapter of Claim 4, further comprising: 
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a hardwired transport offload engine (TOE); 
a processor integrated with said TOE; and 

a module that provides optimized hardware support for a debug mode; 
wherein When a test and control bit is enabled in said network adapter, all IP 
5 packets are sent as exceptions to said host. 

50. The network adapter of Claim 4, further comprising: 

a hardwired transport offload engine (TOE); 
a processor integrated with said TOE; and 
1 0 a module that provides optimized hardware support for TCP time wait state. 

51 . The network adapter of Claim 4, further comprising: 

a hardwired transport offload engine (TOE); 
a processor integrated with said TOE; and 
15 a module that provides optimized hardware support for a variable number of 

connections. 

52. The network adapter of Claim 51 , wherein when said network adapter accepts a 
connection that equals a network adapter maximum capacity, a next SYN is passed 

20 up to said host as an exception packet to allow said host to handle said connection. 

53. The network adapter of Claim 4, further comprising: 

a hardwired transport offload engine (TOE); 
a processor integrated with said TOE; and 
25 a module that provides optimized hardware support for User Datagram Protocol 

(UDP). 
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54. The network adapter of Claim 4, further comprising: 

a hardwired transport offload engine (TOE); 
a processor integrated with said TOE; and 
5 a module that provides optimized hardware support for TTL (time to live) to limit 

an IP packet life on to a selected number of hops. 

55. The network adapter of Claim 4, further comprising: 

a hardwired transport offload engine (TOE); 
10 a processor integrated with said TOE; and 

a module that provides optimized hardware support for TCP keepalive to allow 
an idle TCP connection to stay connected and not time out by periodically sending a 
keep alive packet across a link. 

15 56. The network adapter of Claim 4, further comprising: 
a hardwired transport offload engine (TOE); 
a processor integrated with said TOE; and 

a module that provides optimized hardware support for TCP type of service 
(TOS) for use by routers to prioritize an IP packet. 

20 

57. The network adapter of Claim 4, further comprising: 
a hardwired transport offload engine (TOE); 
a processor integrated with said TOE; and 

a module that provides optimized hardware support for TCP quality of service 

25 (QoS). 
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58. The network adapter of Claim 57, wherein TCP transmit data flow starts with a 
Socket Query module, which goes through a transmit data available Bit table looking 
for entries that have Transmit Data Available bits set, and wherein when said Socket 
Query module finds such an entry, said Socket Query module puts that entry into 

5 one of a plurality of queues according to a socket's User Priority level. 

59. The network adapter of Claim 4, further comprising: 

a hardwired transport offload engine (TOE); 
a processor integrated with said TOE; and 
1 0 a module that provides optimized hardware support for failover. 

60. The network adapter of Claim 59, said failover module comprising: 

a NO_SYN mode that allows a socket to be created without trying to initiate a 
connection; 

15 wherein a socket and all its related data structures in said network adapter are 

created without creating a connection; and 

wherein NO_SYN mode supports failover from another card or connection 
migration from a software TCP/IP stack to said network adapter. 

20 61 . The network adapter of Claim 3, wherein said ULP offloads the calculation of 
the iSCSI CRC for transmit and receive. 

62. The network adapter of Claim 3, wherein said ULP performs iSCSI framing 
using Fixed Interval Markers (FIM) for transmit. 

25 
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63. The network adapter of Claim 3, wherein said TOE accepts iSCSI header 
segments and iSCSI data segments from the host iSCSI driver and prepares iSCSI 
PDUs for transmission. 

64. The network adapter of Claim 3, further comprising: 
an iSCSI driver resident on a host computer; and 

wherein said host iSCSI driver communicates with said TOE. 

65. The network adapter of Claim 64, wherein said TOE receives iSCSI Protocol 
Data Units (PDU), calculates iSCSI CRCs, and passes the iSCSI CRCs to said host 
iSCSI driver. 

66. The network adapter of Claim 64, wherein said host iSCSI driver assembles a 
complete iSCSI Protocol Data Unit (PDU) header in host memory, creates an iSCSI 
Instruction Block (IB), and sends the iSCSI IB to said TOE. 

67. The network adapter of Claim 66, wherein an iSCSI IB contains a set of 
address and length pairs, known as transfer blocks, which correspond to a linked-list 
of buffers in host computer memory. 

68. The network adapter of Claim 67, wherein said host iSCSI driver adjusts 
buffer size of a final transfer block when receiving iSCSI data to account for CRC 
bytes and still allows correct separation of iSCSI header and data segments. 

69. The network adapter of Claim 64, wherein an iSCSI Protocol Data Unit (PDU), 
including its corresponding Basic Header Segment (BHS), any Additional Header 
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Segment (AHS), and any data segment, is transferred between said host iSCSI 
driver and said TOE using an iSCSI Instruction Block (IB). 



70. The network adapter of Claim 65, wherein said host iSCSI driver seeds a 
5 calculated iSCSI CRC value using an iSCSI CRC seed field in an iSCSI Instruction 

Block (IB). 

71. The network adapter of Claim 64, wherein said host iSCSI driver splits iSCSI 
Protocol Data Unit (PDU) header and data segments on receive by posting receive 

10 buffers of the correct size for the iSCSI PDU header and, if there are data segments, 
posting receive buffers of the correct size for the iSCSI PDU data segment. 

72. The network adapter of Claim 71, wherein said host iSCSI driver posts 
correctly sized buffers for any Additional Header Segments (AHS) received by using 

15 instruction blocks. 

73. The network adapter of Claim 64, wherein said TOE and said host iSCSI 
driver interface at the iSCSI PDU level. 

20 74. The network adapter of Claim 64, wherein said TOE separates header and 
data segments of iSCSI Protocol Data Units (PDU) without requiring additional 
memory copies in the host computer's memory by DMAing PDU headers to either 
said integrated processor or the host computer and DMAing PDU data sections to 
the host computer. 

25 

i 
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75. The network adapter of Claim 3, wherein said TOE performs IPsec anti-replay 
support on a per-SA basis. 



76. The network adapter of Claim 3, wherein said TOE implements IPSec null, 
5 DES, 3DES algorithms, and AES 128-bit algorithm in cipher-block chaining (CBC) 

mode. 

77. The network adapter of Claim 3, wherein said TOE implements IPsec null, 
SHA-1 and MD-5 authentication algorithms. 

10 

78. The network adapter of Claim 3, wherein said TOE implements IPsec 
variable-length encryption keys. 

79. The network adapter of Claim 3, wherein said TOE implements IPsec 
15 variable-length authentication keys. 

80. The network adapter of Claim 3, wherein said TOE implements IPsec jumbo 
frame support. 

20 81. The network adapter of Claim 3, wherein said TOE implements IPsec 
automatic handling of Security Association (SA) expiration on the basis of both time 
and total data transferred. 

82. The network adapter of Claim 3, wherein said TOE implements IPsec Policy 
25 Enforcement. 
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83. The network adapter of Claim 3, wherein said TOE implements IPsec 
exception handling, including exception-packet generation and status reporting. 
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